ZwOpenSymbolicLinkObject-Funktion (wdm.h)

  • Artikel

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)

Weitere Informationen

ACCESS_MASK

InitializeObjectAttributes

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwQuerySymbolicLinkObject