Funzione IoSetLinkShareAccess (wdm.h)

Articolo
08/08/2023

La routine IoSetLinkShareAccess imposta i diritti di accesso per la condivisione del collegamento dell'oggetto file specificato.

Sintassi

void IoSetLinkShareAccess(
  [in]                ACCESS_MASK        DesiredAccess,
  [in]                ULONG              DesiredShareAccess,
  [in, out]           PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess,
  [in]                ULONG              IoShareAccessFlags
);

Parametri

[in] DesiredAccess

Specifica un valore ACCESS_MASK che indica il tipo di accesso desiderato all'oggetto file specificato.

[in] DesiredShareAccess

Specifica il tipo desiderato di accesso condiviso all'oggetto file per la richiesta aperta corrente. Il valore di questo parametro è in genere lo stesso del parametro ShareAccess passato al file system o al driver di livello più alto dal gestore di I/O quando è stata effettuata la richiesta aperta. Questo valore può essere zero o qualsiasi combinazione di quanto segue:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Puntatore all'oggetto file per il quale controllare l'accesso per la richiesta aperta 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.

[in] IoShareAccessFlags

Maschera di bit di questi flag:

IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) specifica che l'utente non dispone dell'autorizzazione di scrittura per il file. Questo flag viene usato per impedire l'apertura di un file per l'accesso in lettura esclusivo quando l'utente non dispone delle autorizzazioni appropriate.

IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) indica se la struttura SHARE_ACCESS viene aggiornata.

Valore restituito

nessuno

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

Vedi anche

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess

Condividi tramite