Funzione IoUpdateShareAccess (wdm.h)

La routine IoUpdateShareAccess aggiorna l'accesso di 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 a cui si fa riferimento che rappresenta il file o l'oggetto dispositivo associato per cui aggiornare l'accesso alla condivisione.

[in, out] ShareAccess

Puntatore alla struttura di SHARE_ACCESS comune associata a FileObject. I driver devono trattare 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 impedire il danneggiamento dei conteggi di accesso condiviso.

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

Requisiti

Vedi anche

IoCheckShareAccess

IoRemoveShareAccess

IoSetShareAccess