Compartilhar via

Função ZwQuerySymbolicLinkObject (wdm.h)

  • Artigo

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

Requisito Valor
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

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

ZwOpenSymbolicLinkObject