Compartilhar via


Função NtQuerySymbolicLinkObject

[Essa função pode estar alterada ou indisponível no futuro.]

Recupera o destino de um link simbólico.

Sintaxe

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

Parâmetros

LinkHandle [in]

Um identificador para o objeto de link simbólico.

LinkTarget [in, out]

Um ponteiro para uma cadeia de caracteres Unicode inicializada que recebe o destino do link simbólico. Os membros MaximumLength e Buffer devem ser definidos se a chamada falhar.

ReturnedLength [out, opcional]

Um ponteiro para uma variável que recebe o comprimento da cadeia de caracteres Unicode retornada no parâmetro LinkTarget . Se a função retornar STATUS_BUFFER_TOO_SMALL, essa variável receberá o tamanho do buffer necessário.

Valor retornado

A função retorna STATUS_SUCCESS ou um erro status.

Comentários

Essa função não tem biblioteca de importação ou arquivo de cabeçalho associado; você deve chamá-lo usando as funções LoadLibrary e GetProcAddress .

Requisitos

Requisito Valor
DLL
Ntdll.dll

Confira também

NtOpenSymbolicLinkObject