IoSetLinkShareAccess-Funktion (wdm.h)

  • Artikel

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 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] 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 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_CHECK_SHARE_ACCESS_UPDATE_SHARE_ACCESS (0x00000001) gibt an, ob die SHARE_ACCESS-Struktur aktualisiert wird.

Rückgabewert

Keine

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

IoCheckLinkShareAccess

IoRemoveLinkShareAccess

IoUpdateLinkShareAccess