IoRemoveShareAccess-Funktion (wdm.h)
Die IoRemoveShareAccess Routine entfernt die Zugriffs- und Freigabezugriffsinformationen für eine bestimmte geöffnete Instanz eines Dateiobjekts.
Syntax
void IoRemoveShareAccess(
[in] PFILE_OBJECT FileObject,
[in, out] PSHARE_ACCESS ShareAccess
);
Parameter
[in] FileObject
Zeigen Sie auf das Dateiobjekt, das normalerweise vom aktuellen Thread geschlossen wird.
[in, out] ShareAccess
Zeiger auf die Share-Access-Struktur, die beschreibt, wie auf das geöffnete Dateiobjekt derzeit zugegriffen wird.
Rückgabewert
Nichts
Bemerkungen
Diese Routine ist ein Kehrwert IoUpdateShareAccess.
IoRemoveShareAccess ist keine atomische Operation. Daher müssen Treiber, die diese Routine aufrufen, das freigegebene Dateiobjekt schützen, das an IoRemoveShareAccess durch eine Art von Sperre, z. B. einen Mutex oder eine Ressourcensperre, übergeben wird, um Beschädigungen der Anzahl des freigegebenen Zugriffs zu verhindern.
Aufrufer von IoRemoveShareAccess- 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- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | PASSIVE_LEVEL (siehe Abschnitt "Hinweise") |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |