Função ZwQuerySymbolicLinkObject (wdm.h)

A rotina ZwQuerySymbolicLinkObject retorna uma cadeia de caracteres Unicode que contém o destino de um link simbólico.

Sintaxe

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

Parâmetros

[in] LinkHandle

Manipule para o objeto de link simbólico que você deseja consultar. Esse identificador é criado por uma chamada bem-sucedida para ZwOpenSymbolicLinkObject.

[in, out] LinkTarget

Ponteiro para uma cadeia de caracteres Unicode inicializada que recebe o destino do link simbólico.

[out, optional] ReturnedLength

contém o número máximo de bytes a serem copiados para a cadeia de caracteres Unicode em LinkTarget. Na saída, o inteiro longo sem sinal contém o comprimento da cadeia de caracteres Unicode nomeando o destino do link simbólico.

Retornar valor

ZwQuerySymbolicLinkObject retorna STATUS_SUCCESS para indicar a rotina concluída sem erro ou STATUS_BUFFER_TOO_SMALL se a cadeia de caracteres Unicode fornecida em LinkTarget for muito pequena para manter a cadeia de caracteres retornada.

Comentários

Antes de chamar essa rotina, os gravadores de driver devem garantir que a cadeia de caracteres Unicode em LinkTarget tenha sido inicializada corretamente e que um buffer para a cadeia de caracteres tenha sido alocado. Os membros MaximumLength e Buffer da cadeia de caracteres Unicode devem ser definidos antes de chamar ZwQuerySymbolicLinkObject ou a chamada falhará.

Se ZwQuerySymbolicLinkObject retornar STATUS_BUFFER_TOO_SMALL drivers deverão examinar o valor retornado em ReturnedLength. O número retornado nessa variável indica o comprimento máximo que a cadeia de caracteres Unicode para o destino do link simbólico.

Se a chamada para essa função ocorrer no modo de usuário, você deverá usar o nome "NtQuerySymbolicLinkObject" em vez de "ZwQuerySymbolicLinkObject".

Para chamadas de drivers de modo kernel, as versões NtXxx e ZwXxx de uma rotina do Windows Native System Services podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Confira também

Usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwOpenSymbolicLinkObject