Funzione IoUpdateLinkShareAccess (wdm.h)

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

Sintassi

void IoUpdateLinkShareAccess(
  [in]                PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess
);

Parametri

[in] FileObject

Puntatore all'oggetto file, che in genere viene chiuso dal thread 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, out, optional] LinkShareAccess

Puntatore alla struttura dei dati di accesso condiviso di collegamento comune (LINK_SHARE_ACCESS) associata a FileObject. I driver devono considerare questa struttura come opaca.

Valore restituito

nessuno

Osservazioni

IoUpdateLinkShareAccess non è un'operazione atomica. Pertanto, i driver che chiamano questa routine devono proteggere l'oggetto file condiviso passato a IoUpdateLinkShareAccess 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 IoUpdateLinkShareAccess, il chiamante deve chiamare correttamente IoCheckLinkShareAccess con Update impostato su False. Una chiamata di questo tipo a IoCheckLinkShareAccess determina se l'accesso condiviso richiesto è compatibile con il modo in cui l'oggetto file è attualmente accessibile da altri elementi aperti, ma non aggiorna la struttura SHARE_ACCESS . IoUpdateLinkShareAccess aggiorna effettivamente la struttura SHARE_ACCESS associata all'oggetto file.

Requisiti

Vedi anche

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoSetLinkShareAccess