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
| 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 |
| DLL- | NtosKrnl.exe |
| IRQL- | PASSIVE_LEVEL |