Función ZwQuerySymbolicLinkObject (wdm.h)

La rutina ZwQuerySymbolicLinkObject devuelve una cadena Unicode que contiene el destino de un vínculo simbólico.

Sintaxis

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

Parámetros

[in] LinkHandle

Controle el objeto de vínculo simbólico que desea consultar. Este identificador se crea mediante una llamada correcta a ZwOpenSymbolicLinkObject.

[in, out] LinkTarget

Puntero a una cadena Unicode inicializada que recibe el destino del vínculo simbólico.

[out, optional] ReturnedLength

contiene el número máximo de bytes que se van a copiar en la cadena Unicode en LinkTarget. En la salida, el entero largo sin signo contiene la longitud de la cadena Unicode que asigna el nombre al destino del vínculo simbólico.

Valor devuelto

ZwQuerySymbolicLinkObject devuelve STATUS_SUCCESS para indicar la rutina completada sin error o STATUS_BUFFER_TOO_SMALL si la cadena Unicode proporcionada en LinkTarget es demasiado pequeña para contener la cadena devuelta.

Comentarios

Antes de llamar a esta rutina, los escritores de controladores deben asegurarse de que la cadena Unicode de LinkTarget se ha inicializado correctamente y se ha asignado un búfer para la cadena. Los miembros MaximumLength y Buffer de la cadena Unicode deben establecerse antes de llamar a ZwQuerySymbolicLinkObject o se producirá un error en la llamada.

Si ZwQuerySymbolicLinkObject devuelve STATUS_BUFFER_TOO_SMALL controladores deben examinar el valor devuelto en ReturnedLength. El número devuelto en esta variable indica la longitud máxima que la cadena Unicode para el destino del vínculo simbólico.

Si la llamada a esta función se produce en modo de usuario, debe usar el nombre "NtQuerySymbolicLinkObject" en lugar de "ZwQuerySymbolicLinkObject".

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

Uso de las versiones Nt y Zw de las rutinas nativas de System Services

ZwOpenSymbolicLinkObject