Funzione IoCheckShareAccessEx (wdm.h)

La routine IoCheckShareAccessEx viene chiamata dai driver del file system (FSD) o da altri driver di livello più alto per verificare se è consentito l'accesso condiviso a un oggetto file.

Sintassi

NTSTATUS IoCheckShareAccessEx(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess,
  [in]      BOOLEAN       Update,
  [in]      PBOOLEAN      WritePermission
);

Parametri

[in] DesiredAccess

Specifica un valore ACCESS_MASK che indica il tipo di accesso desiderato all'oggetto file specificato.

[in] DesiredShareAccess

Specifica il tipo desiderato di accesso condiviso all'oggetto file per la richiesta aperta corrente. Il valore di questo parametro è in genere lo stesso del parametro ShareAccess passato al file system o al driver di livello più alto dal gestore di I/O quando è stata effettuata la richiesta aperta. Questo valore può essere zero o qualsiasi combinazione di quanto segue:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Puntatore all'oggetto file per il quale controllare l'accesso per la richiesta aperta corrente.

[in, out] ShareAccess

Puntatore alla struttura dei dati di accesso condiviso comune associata a FileObject. I driver devono considerare questa struttura come opaca.

[in] Update

Specifica se aggiornare lo stato di accesso alla condivisione per FileObject. Un valore booleano TRUE indica che questa routine aggiornerà le informazioni di accesso alla condivisione per l'oggetto file se la richiesta aperta è consentita.

[in] WritePermission

Specifica se l'accesso alla condivisione dispone dell'autorizzazione di scrittura. Questo valore è TRUE se la condivisione dispone dell'autorizzazione di scrittura; in caso contrario, FALSE. Se il valore è FALSE e l'accesso alla condivisione dispone dell'autorizzazione di scrittura e il chiamante tenta di accedere in lettura esclusivo, l'autorizzazione di scrittura viene sottoposta a downgrade a FILE_SHARE_READ. Questo valore è NULL se non viene eseguito un controllo delle autorizzazioni di scrittura per l'accesso alla condivisione.

Valore restituito

La routine IoCheckShareAccessEx restituisce STATUS_SUCCESS se l'accesso del richiedente all'oggetto file è compatibile con il modo in cui è attualmente aperto. Se la richiesta viene negata a causa di una violazione di condivisione, viene restituita STATUS_SHARING_VIOLATION.

Requisiti

Vedi anche

Routine di I/O Manager