Fonction IoSetShareAccessEx (wdm.h)

La routine IoSetShareAccessEx définit les droits d’accès pour le partage de l’objet de fichier spécifié.

Syntaxe

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

Paramètres

[in] DesiredAccess

Spécifie une valeur ACCESS_MASK qui représente le type d’accès demandé pour l’objet file. Consultez IoCreateFile pour obtenir la liste complète des indicateurs DesiredAccess définis par le système.

[in] DesiredShareAccess

Spécifie le type d’accès au partage à définir pour l’objet fichier. Cette valeur peut être égale à zéro ou à n’importe quelle combinaison des indicateurs suivants :

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Pointeur vers l’objet fichier dont l’accès au partage est défini ou réinitialisé.

[out] ShareAccess

Pointeur vers la structure SHARE_ACCESS associée à FileObject. Les pilotes doivent traiter cette structure comme opaque.

[in, optional] WritePermission

Pointeur vers la valeur qui spécifie si l’objet fichier dispose d’une autorisation d’écriture. Cette valeur est TRUE si le partage dispose d’une autorisation d’écriture ; sinon, elle est FALSE. Si la valeur est FALSE et que l’appelant tente d’obtenir un accès en lecture exclusif, l’autorisation d’écriture est rétrogradée en FILE_SHARE_READ.

Valeur de retour

None

Configuration requise

Voir aussi

ACCESS_MASK

IoCreateFile