IoSetLinkShareAccess-Funktion (wdm.h)

Artikel
02/07/2025

Die IoSetLinkShareAccess Routine legt die Zugriffsrechte für die Linkfreigabe des angegebenen Dateiobjekts fest.

Syntax

void IoSetLinkShareAccess(
  [in]                ACCESS_MASK        DesiredAccess,
  [in]                ULONG              DesiredShareAccess,
  [in, out]           PFILE_OBJECT       FileObject,
  [in, out]           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 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, out, optional] LinkShareAccess

Ein Zeiger auf die gemeinsame Verknüpfungsfreigabe-Datenstruktur (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 keine Schreibberechtigung für die Datei besitzt. Dieses Flag wird verwendet, um das Öffnen einer Datei für den exklusiven Lesezugriff zu verhindern, wenn der Benutzer nicht über entsprechende Berechtigungen verfügt.

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

Rückgabewert

Nichts

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1709
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Universal
Header-	wdm.h
Library	Ntoskrnl.lib

Siehe auch

IoCheckLinkShareAccess-

IoRemoveLinkShareAccess-

IoUpdateLinkShareAccess

Freigeben über