Funzione IoUpdateShareAccess (wdm.h)

La routine IoUpdateShareAccess aggiorna l'accesso alla condivisione per l'oggetto file specificato, in genere quando il file viene aperto.

Sintassi

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

Parametri

[in] FileObject

Puntatore a un oggetto file di riferimento che rappresenta il file o l'oggetto dispositivo associato per il quale aggiornare l'accesso alla condivisione.

[in, out] ShareAccess

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

Valore restituito

nessuno

Osservazioni

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

Prima di chiamare IoUpdateShareAccess, il chiamante deve chiamare correttamente IoCheckShareAccess con Update impostato su False. Una chiamata di questo tipo a IoCheckShareAccess determina se l'accesso condiviso richiesto è compatibile con il modo in cui l'oggetto file è attualmente accessibile da altri oggetti aperti, ma non aggiorna la struttura SHARE_ACCESS . IoUpdateShareAccess aggiorna effettivamente la struttura SHARE_ACCESS associata all'oggetto file.

Requisiti

   
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), PowerIrpDDis(wdm)

Vedi anche

IoCheckShareAccess

IoRemoveShareAccess

IoSetShareAccess