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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h |
| Libreria | Ntoskrnl.lib |