ZwOpenSymbolicLinkObject-Funktion (wdm.h)
Die ZwOpenSymbolicLinkObject-Routine öffnet eine vorhandene symbolische Verknüpfung.
Syntax
NTSYSAPI NTSTATUS ZwOpenSymbolicLinkObject(
[out] PHANDLE LinkHandle,
[in] ACCESS_MASK DesiredAccess,
[in] POBJECT_ATTRIBUTES ObjectAttributes
);
Parameter
[out] LinkHandle
Zeiger auf eine HANDLE-Variable, die ein Handle auf das symbolische Linkobjekt empfängt.
[in] DesiredAccess
Gibt einen ACCESS_MASK Wert an, der den angeforderten Zugriff auf das Objekt bestimmt. Der Aufrufer gibt normalerweise GENERIC_READ an, damit das Handle an ZwQuerySymbolicLinkObject übergeben werden kann.
[in] ObjectAttributes
Zeiger auf eine OBJECT_ATTRIBUTES-Struktur , die den Objektnamen und andere Attribute angibt. Verwenden Sie InitializeObjectAttributes , um diese Struktur zu initialisieren. Wenn der Aufrufer nicht in einem Systemthreadkontext ausgeführt wird, muss er das attribut OBJ_KERNEL_HANDLE festlegen, wenn initializeObjectAttributes aufgerufen wird.
Rückgabewert
ZwOpenSymbolicLinkObject gibt STATUS_SUCCESS bei Erfolg oder dem entsprechenden Fehler status zurück.
Hinweise
Sobald der von LinkHandle angezeigte Handle nicht mehr verwendet wird, muss der Treiber ZwClose aufrufen, um ihn zu schließen.
Wenn der Aufrufer nicht in einem Systemthreadkontext ausgeführt wird, muss er sicherstellen, dass alle von dem Aufrufer erstellten Handles private Handles sind. Andernfalls kann der Prozess, in dessen Kontext der Treiber ausgeführt wird, auf das Handle zugreifen. Weitere Informationen finden Sie unter Objekthandles.
Wenn der Aufruf der ZwOpenSymbolicLinkObject-Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtOpenSymbolicLinkObject" anstelle von "ZwOpenSymbolicLinkObject" verwenden.
NtOpenSymbolicLinkObject und ZwOpenSymbolicLinkObject sind zwei Versionen derselben Windows Native System Services-Routine. Die NtOpenSymbolicLinkObject-Routine im Windows-Kernel ist für Kernelmodustreiber nicht direkt zugänglich. Kernelmodustreiber können jedoch indirekt auf diese Routine zugreifen, indem sie die ZwOpenSymbolicLinkObject-Routine aufrufen.
Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, da sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |