IoRemoveLinkShareAccess-Funktion (wdm.h)

Die IoRemoveLinkShareAccess Routine entfernt die Zugriffs- und Linkinformationen für einen bestimmten geöffneten Instanz eines Dateiobjekts.

Syntax

VOID IoRemoveLinkShareAccess(
  [in]                PFILE_OBJECT       FileObject,
  [in, out]           PSHARE_ACCESS      ShareAccess,
  [in, out, optional] PLINK_SHARE_ACCESS LinkShareAccess
);

Parameter

[in] FileObject

Zeigen Sie auf das Dateiobjekt, das normalerweise vom aktuellen Thread geschlossen wird.

[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.

Rückgabewert

Nichts

Bemerkungen

Diese Routine ist ein Kehrwert IoUpdateLinkShareAccess.

IoRemoveLinkShareAccess ist keine atomische Operation. Daher müssen Treiber, die diese Routine aufrufen, das freigegebene Dateiobjekt schützen, das an IoRemoveLinkShareAccess durch eine Art von Sperre, z. B. einen Mutex oder eine Ressourcensperre, übergeben wird, um eine Beschädigung der Anzahl der freigegebenen Zugriffe zu verhindern.

Aufrufer von IoRemoveLinkShareAccess- müssen unter IRQL = PASSIVE_LEVEL und im Kontext des Threads ausgeführt werden, der angefordert hat, dass das FileObject geschlossen.

Anforderungen

Siehe auch

IoCheckLinkShareAccess-

IoSetLinkShareAccess-

IoUpdateLinkShareAccess