NtQuerySymbolicLinkObject-Funktion

[Diese Funktion kann geändert oder in Zukunft nicht mehr verfügbar sein.]

Ruft das Ziel eines symbolischen Links ab.

Syntax

NTSTATUS WINAPI NtQuerySymbolicLinkObject(
  _In_      HANDLE          LinkHandle,
  _Inout_   PUNICODE_STRING LinkTarget,
  _Out_opt_ PULONG          ReturnedLength
);

Parameter

LinkHandle [in]

Ein Handle für das symbolische Linkobjekt.

LinkTarget [in, out]

Ein Zeiger auf eine initialisierte Unicode-Zeichenfolge, die das Ziel der symbolischen Verknüpfung empfängt. Die Elemente MaximumLength und Buffer müssen festgelegt werden, wenn der Aufruf fehlschlägt.

ReturnedLength [out, optional]

Ein Zeiger auf eine Variable, die die Länge der unicode-Zeichenfolge empfängt, die im LinkTarget-Parameter zurückgegeben wird. Wenn die Funktion STATUS_BUFFER_TOO_SMALL zurückgibt, erhält diese Variable die erforderliche Puffergröße.

Rückgabewert

Die Funktion gibt STATUS_SUCCESS oder einen Fehler status zurück.

Bemerkungen

Dieser Funktion ist keine Importbibliothek oder Headerdatei zugeordnet. Sie müssen sie mit den Funktionen LoadLibrary und GetProcAddress aufrufen.

Anforderungen

Siehe auch

NtOpenSymbolicLinkObject