Funzione IoSetShareAccess (wdm.h)

Articolo
02/27/2024

La routine IoSetShareAccess imposta i diritti di accesso per la condivisione dell'oggetto file specificato.

Sintassi

void IoSetShareAccess(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [out]     PSHARE_ACCESS ShareAccess
);

Parametri

[in] DesiredAccess

Specifica un valore ACCESS_MASK che rappresenta il tipo di accesso richiesto per FileObject. Per un elenco completo dei flag DesiredAccess definiti dal sistema, vedere IoCreateFile.

[in] DesiredShareAccess

Specifica il tipo di accesso alla condivisione da impostare per l'oggetto file. 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 di cui è in corso l'impostazione o la reimpostazione dell'accesso alla condivisione.

[out] ShareAccess

Puntatore alla struttura SHARE_ACCESS associata a FileObject. I driver devono considerare questa struttura come opaca.

Valore restituito

nessuno

Osservazioni

Solo i driver in modalità kernel di livello più alto devono chiamare questa routine. La chiamata deve essere eseguita nel contesto del primo thread che tenta di aprire FileObject.

Questa routine imposta le informazioni di accesso e condivisione quando l'oggetto FileObject viene aperto per la prima volta. Restituisce un puntatore alla struttura dei dati di accesso condiviso comune associata a FileObject. I chiamanti devono salvare questo puntatore per usarlo in un secondo momento durante l'aggiornamento dell'accesso o la chiusura del file.

In genere, è molto probabile che i driver del file system (FSD) chiamino questa routine. Tuttavia, altri driver di livello più alto possono chiamare IoSetShareAccess per controllare il tipo di accesso consentito a un oggetto dispositivo creato dal driver associato al fileObject specificato.

IoSetShareAccess non è un'operazione atomica. Pertanto, i driver che chiamano questa routine devono proteggere l'oggetto file condiviso passato a IoSetShareAccess tramite un tipo di blocco, ad esempio un mutex o un blocco di risorse, per evitare il danneggiamento dei conteggi di accesso condiviso.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm)