ZwQuerySymbolicLinkObject-Funktion (wdm.h)

  • Artikel

Die ZwQuerySymbolicLinkObject-Routine gibt eine Unicode-Zeichenfolge zurück, die das Ziel eines symbolischen Links enthält.

Syntax

NTSYSAPI NTSTATUS ZwQuerySymbolicLinkObject(
  [in]            HANDLE          LinkHandle,
  [in, out]       PUNICODE_STRING LinkTarget,
  [out, optional] PULONG          ReturnedLength
);

Parameter

[in] LinkHandle

Handle für das symbolträchtige Linkobjekt, das Sie abfragen möchten. Dieses Handle wird durch einen erfolgreichen Aufruf von ZwOpenSymbolicLinkObject erstellt.

[in, out] LinkTarget

Zeiger auf eine initialisierte Unicode-Zeichenfolge, die das Ziel des symbolischen Links empfängt.

[out, optional] ReturnedLength

enthält die maximale Anzahl von Bytes, die in die Unicode-Zeichenfolge bei LinkTarget kopiert werden sollen. Bei der Ausgabe enthält die ganze Zahl ohne Vorzeichen die Länge der Unicode-Zeichenfolge, die das Ziel des symbolischen Links benennt.

Rückgabewert

ZwQuerySymbolicLinkObject gibt entweder STATUS_SUCCESS zurück, um die ohne Fehler abgeschlossene Routine anzugeben, oder STATUS_BUFFER_TOO_SMALL, wenn die auf LinkTarget bereitgestellte Unicode-Zeichenfolge zu klein ist, um die zurückgegebene Zeichenfolge zu enthalten.

Hinweise

Vor dem Aufrufen dieser Routine müssen Treiberautoren sicherstellen, dass die Unicode-Zeichenfolge bei LinkTarget ordnungsgemäß initialisiert und ein Puffer für die Zeichenfolge zugewiesen wurde. Die Elemente MaximumLength und Buffer der Unicode-Zeichenfolge müssen vor dem Aufruf von ZwQuerySymbolicLinkObject festgelegt werden, andernfalls schlägt der Aufruf fehl.

Wenn ZwQuerySymbolicLinkObject STATUS_BUFFER_TOO_SMALL Treiber den unter ReturnedLength zurückgegebenen Wert überprüfen sollten. Die in dieser Variable zurückgegebene Zahl gibt die maximale Länge der Unicode-Zeichenfolge für das Ziel der symbolischen Verknüpfung an.

Wenn der Aufruf dieser Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtQuerySymbolicLinkObject" anstelle von "ZwQuerySymbolicLinkObject" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, wie 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 systemeigenen 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 HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwOpenSymbolicLinkObject