IoCheckShareAccessEx-Funktion (wdm.h)

Die IoCheckShareAccessEx-Routine wird von Dateisystemtreibern (FSDs) oder anderen Treibern der höchsten Ebene aufgerufen, um zu überprüfen, ob der freigegebene Zugriff auf ein Dateiobjekt zulässig ist.

Syntax

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
);

Parameter

[in] DesiredAccess

Gibt einen ACCESS_MASK-Wert an, der den gewünschten Zugriffstyp auf das angegebene Dateiobjekt angibt.

[in] DesiredShareAccess

Gibt den gewünschten Typ des freigegebenen Zugriffs auf das Dateiobjekt für die aktuelle offene Anforderung an. Der Wert dieses Parameters ist normalerweise mit dem ShareAccess-Parameter identisch, der vom E/A-Manager an das Dateisystem oder den Treiber der höchsten Ebene übergeben wird, wenn die offene Anforderung gestellt wurde. Dieser Wert kann null oder eine beliebige Kombination aus folgendem Wert sein:

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

Ein Zeiger auf das Dateiobjekt, für das der Zugriff auf die aktuelle offene Anforderung überprüft werden soll.

[in, out] ShareAccess

Ein Zeiger auf die gemeinsame Datenstruktur für den Freigabezugriff, die FileObject zugeordnet ist. Treiber sollten diese Struktur als undurchsichtig behandeln.

[in] Update

Gibt an, ob die share-access-status für FileObject aktualisiert werden soll. Ein boolescher Wert von TRUE bedeutet, dass diese Routine die Freigabezugriffsinformationen für das Dateiobjekt aktualisiert, wenn die offene Anforderung zulässig ist.

[in] WritePermission

Gibt an, ob der Freigabezugriff über schreibberechtigungen verfügt. Dieser Wert ist TRUE, wenn die Freigabe über die Schreibberechtigung verfügt. andernfalls FALSE. Wenn der Wert FALSE ist und der Freigabezugriff über schreibberechtigungen verfügt und der Aufrufer versucht, exklusiven Lesezugriff zu nehmen, wird die Schreibberechtigung auf FILE_SHARE_READ herabgestuft. Dieser Wert ist NULL, wenn keine Schreibberechtigungsprüfung für den Freigabezugriff durchgeführt wird.

Rückgabewert

Die IoCheckShareAccessEx-Routine gibt STATUS_SUCCESS zurück, wenn der Zugriff des Anforderers auf das Dateiobjekt mit der Art und Weise kompatibel ist, in der es derzeit geöffnet ist. Wenn die Anforderung aufgrund einer Freigabeverletzung abgelehnt wird, wird STATUS_SHARING_VIOLATION zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Zielplattform	Universell
Header	wdm.h
Bibliothek	Ntoskrnl.lib

Weitere Informationen

E/A-Manager-Routinen