ZwQuerySymbolicLinkObject-Funktion (wdm.h)
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) |