Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IoCheckShareAccessEx Routine wird von Dateisystemtreibern (FSDs) oder anderen Treibern auf höchster 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 in der Regel mit dem ShareAccess-Parameter identisch, der vom E/A-Manager beim Senden der offenen Anforderung an das Dateisystem oder den Treiber der höchsten Ebene übergeben wird. Dieser Wert kann null oder eine beliebige Kombination der folgenden Werte 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 geöffnete 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 der Freigabezugriffsstatus 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 schreibberechtigungen hat. andernfalls FALSE. Wenn der Wert FALSE ist und der Freigabezugriff schreibberechtigungen hat und der Aufrufer versucht, exklusiven Lesezugriff zu übernehmen, wird die Schreibberechtigung auf FILE_SHARE_READ herabgestuft. Dieser Wert ist NULL, wenn für den Freigabezugriff keine Schreibberechtigungsprüfung durchgeführt wird.
Rückgabewert
Die IoCheckShareAccessEx- Routine gibt STATUS_SUCCESS zurück, wenn der Zugriff des Antragstellers auf das Dateiobjekt mit der Art und Weise kompatibel ist, in der er derzeit geöffnet ist. Wenn die Anforderung aufgrund eines Freigabeverstoßes verweigert wird, wird STATUS_SHARING_VIOLATION zurückgegeben.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
Zielplattform- | Universal |
Header- | wdm.h |
Library | Ntoskrnl.lib |