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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10, versione 1709 |
| Server minimo supportato | Windows Server 2016 |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |