Funzione IoRemoveShareAccess (wdm.h)

Articolo
08/08/2023

La routine IoRemoveShareAccess rimuove le informazioni di accesso e accesso condiviso per una determinata istanza aperta di un oggetto file.

Sintassi

void IoRemoveShareAccess(
  [in]      PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess
);

Parametri

[in] FileObject

Puntatore all'oggetto file, che in genere viene chiuso dal thread corrente.

[in, out] ShareAccess

Puntatore alla struttura di accesso condiviso che descrive come si accede all'oggetto file aperto.

Valore restituito

nessuno

Osservazioni

Questa routine è un reciproco per IoUpdateShareAccess.

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

I chiamanti di IoRemoveShareAccess devono essere in esecuzione in IRQL = PASSIVE_LEVEL e nel contesto del thread che richiedeva la chiusura dell'oggetto FileObject .

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 (vedere la sezione Osservazioni)
Regole di conformità DDI	HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

Vedi anche

IoCheckShareAccess

IoSetShareAccess

IoUpdateShareAccess

Condividi tramite