IoCheckLinkShareAccess-Funktion (wdm.h)

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

Syntax

NTSTATUS IoCheckLinkShareAccess(
  [in]                ACCESS_MASK        DesiredAccess,
  [in]                ULONG              DesiredShareAccess,
  [in, out, optional] PFILE_OBJECT       FileObject,
  [in, out, optional] PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess,
  [in]                ULONG              IoShareAccessFlags
);

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 entspricht in der Regel dem ShareAccess-Parameter , der vom E/A-Manager an das Dateisystem oder den Treiber der obersten 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, optional] FileObject

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

[in, out, optional] ShareAccess

Ein Zeiger auf die gemeinsame Freigabezugriffsdatenstruktur, die FileObject zugeordnet ist. Treiber sollten diese Struktur als undurchsichtig behandeln.

[in, out, optional] LinkShareAccess

Ein Zeiger auf die common link share-access data structure (LINK_SHARE_ACCESS), die FileObject zugeordnet ist. Treiber sollten diese Struktur als undurchsichtig behandeln.

[in] IoShareAccessFlags

Eine Bitmaske dieser Flags:

IO_SHARE_ACCESS_NO_WRITE_PERMISSION (0x80000000) gibt an, dass der Benutzer über keine Schreibberechtigung für die Datei verfügt. Dieses Flag wird verwendet, um das Öffnen einer Datei für exklusiven Lesezugriff zu verhindern, wenn der Benutzer nicht über die entsprechenden Berechtigungen verfügt.

IO_SHARE_ACCESS_NON_PRIMARY_STREAM (0x00000080) gibt an, dass der Datenstrom weder der primäre Datenstrom noch ein Verzeichnisdatenstrom ist.

IO_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) gibt an, ob die SHARE_ACCESS-Struktur aktualisiert wird.

IO_CHECK_SHARE_ACCESS_DONT_UPDATE_FILE_OBJECT (0x00000002) gibt an, dass FILE_OBJECT Struktur nicht aktualisiert wird.

IO_CHECK_SHARE_ACCESS_DONT_CHECK_READ (0x00000004) gibt an, dass der Lesefreigabezugriff nicht überprüft wird.

IO_CHECK_SHARE_ACCESS_DONT_CHECK_WRITE (0x00000008) gibt an, dass der Schreibfreigabezugriff nicht überprüft wird.

IO_CHECK_SHARE_ACCESS_DONT_CHECK_DELETE (0x00000010) gibt an, dass der Löschfreigabezugriff nicht überprüft wird.

IO_CHECK_SHARE_ACCESS_FORCE_CHECK (0x00000020) angeben, dass der Freigabezugriff auch dann überprüft werden soll, wenn die Anforderung keinen Lese-/Schreib-/Löschzugriff hat.

IO_CHECK_SHARE_ACCESS_FORCE_USING_SCB (0x00000040) gibt an, die Überprüfung des Freigabezugriffs mithilfe von ShareAccess zu erzwingen, unabhängig davon, ob LinkShareAccess vorhanden ist oder nicht.

Rückgabewert

Die IoCheckLinkShareAccess-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 eines Freigabeverstoßes abgelehnt wird, wird STATUS_SHARING_VIOLATION zurückgegeben.

Hinweise

Der ShareAccess-Parameter muss für andere Zugriffe von anderen Threads gesperrt werden, während diese Routine ausgeführt wird. Andernfalls kann die Anzahl Synchronisierung sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Universell
Header	wdm.h
Bibliothek	Ntoskrnl.lib

Weitere Informationen

E/A-Managerroutinen

IoRemoveLinkShareAccess

IoSetLinkShareAccess

IoUpdateLinkShareAccess