Fonction IoCheckShareAccessEx (wdm.h)

La routine IoCheckShareAccessEx est appelée par les pilotes de système de fichiers (FSD) ou d’autres pilotes de niveau supérieur pour case activée si l’accès partagé à un objet de fichier est autorisé.

Syntaxe

NTSTATUS IoCheckShareAccessEx(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess,
  [in]      BOOLEAN       Update,
  [in]      PBOOLEAN      WritePermission
);

Paramètres

[in] DesiredAccess

Spécifie une valeur ACCESS_MASK qui indique le type d’accès souhaité à l’objet de fichier donné.

[in] DesiredShareAccess

Spécifie le type souhaité d’accès partagé à l’objet de fichier pour la demande ouverte actuelle. La valeur de ce paramètre est généralement identique au paramètre ShareAccess qui est passé au système de fichiers ou au pilote de niveau supérieur par le gestionnaire d’E/S lorsque la demande ouverte a été effectuée. Cette valeur peut être zéro ou n’importe quelle combinaison des éléments suivants :

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Pointeur vers l’objet fichier pour lequel case activée accès pour la demande ouverte actuelle.

[in, out] ShareAccess

Pointeur vers la structure de données d’accès au partage commune associée à FileObject. Les pilotes doivent traiter cette structure comme opaque.

[in] Update

Spécifie s’il faut mettre à jour le status d’accès au partage pour FileObject. Une valeur booléenne TRUE signifie que cette routine met à jour les informations d’accès au partage pour l’objet fichier si la demande ouverte est autorisée.

[in] WritePermission

Spécifie si l’accès au partage dispose d’une autorisation d’écriture. Cette valeur est TRUE si le partage dispose d’une autorisation d’écriture ; sinon, FALSE. Si la valeur est FALSE et que l’accès au partage dispose d’une autorisation d’écriture 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. Cette valeur est NULL si une autorisation d’écriture case activée n’est pas effectuée sur l’accès au partage.

Valeur retournée

La routine IoCheckShareAccessEx retourne STATUS_SUCCESS si l’accès du demandeur à l’objet de fichier est compatible avec la façon dont il est actuellement ouvert. Si la demande est refusée en raison d’une violation de partage, STATUS_SHARING_VIOLATION est retourné.

Configuration requise

Voir aussi

Routines du Gestionnaire d’E/S