Funzione IoSetShareAccessEx (wdm.h)

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

Sintassi

void IoSetShareAccessEx(
  [in]           ACCESS_MASK   DesiredAccess,
  [in]           ULONG         DesiredShareAccess,
  [in, out]      PFILE_OBJECT  FileObject,
  [out]          PSHARE_ACCESS ShareAccess,
  [in, optional] PBOOLEAN      WritePermission
);

Parametri

[in] DesiredAccess

Specifica un valore ACCESS_MASK che rappresenta il tipo di accesso richiesto per l'oggetto file. Per un elenco completo dei flag DesiredAccess definiti dal sistema, vedere IoCreateFile.

[in] DesiredShareAccess

Specifica il tipo di accesso alla condivisione da impostare per l'oggetto file. Questo valore può essere zero o qualsiasi combinazione dei flag seguenti:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Puntatore all'oggetto file di cui è in corso l'impostazione o la reimpostazione dell'accesso alla condivisione.

[out] ShareAccess

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

[in, optional] WritePermission

Puntatore al valore che specifica se l'oggetto file dispone dell'autorizzazione di scrittura. Questo valore è TRUE se la condivisione dispone dell'autorizzazione di scrittura; in caso contrario, è FALSE. Se il valore è FALSE e il chiamante tenta di accedere in lettura esclusivo, l'autorizzazione di scrittura viene sottoposta a downgrade a FILE_SHARE_READ.

Valore restituito

nessuno

Requisiti

Vedi anche

ACCESS_MASK

IoCreateFile