Função LsaQueryTrustedDomainInfoByName (ntsecapi.h)

Artigo
03/13/2024

A função LsaQueryTrustedDomainInfoByName retorna informações sobre um domínio confiável.

Sintaxe

NTSTATUS LsaQueryTrustedDomainInfoByName(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PLSA_UNICODE_STRING       TrustedDomainName,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

Parâmetros

[in] PolicyHandle

Um identificador para um objeto Policy . Esse identificador deve ter o acesso POLICY_VIEW_LOCAL_INFORMATION correto. Para obter mais informações, consulte Abrindo um identificador de objeto de política.

[in] TrustedDomainName

Cadeia de caracteres que contém o nome do domínio confiável. Pode ser o nome de domínio ou o nome simples.

[in] InformationClass

Especifica o tipo de informação a ser recuperado. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
TrustedDomainNameInformation	Nome do domínio confiável.
TrustedPosixInformation	Deslocamento posix do domínio confiável.
TrustedPasswordInformation	Retorna a senha no lado de saída da relação de confiança.
TrustedDomainInformationBasic	Não há suporte para esse valor.
TrustedDomainInformationEx	Informações de confiança estendidas, incluindo as informações básicas e o nome de domínio DNS e atributos sobre a confiança.
TrustedDomainFullInformation	Informações completas, incluindo o deslocamento posix e as informações de autenticação.

[out] Buffer

Recebe um ponteiro para o buffer retornado que contém as informações solicitadas. O formato e o conteúdo desse buffer dependem da classe de informações. Por exemplo, se InformationClass for definido como TrustedDomainInformationEx, Buffer receberá um ponteiro para uma estrutura TRUSTED_DOMAIN_INFORMATION_EX . Para obter mais informações, consulte TRUSTED_INFORMATION_CLASS.

Quando terminar de usar o buffer, libere-o chamando a função LsaFreeMemory .

Retornar valor

Se a função for bem-sucedida, a função retornará STATUS_SUCCESS.

Se a função falhar, ela retornará um valor NTSTATUS , que pode ser um dos valores a seguir ou um dos valores retornados da função de política LSA.

Valor	Descrição
STATUS_ACCESS_DENIED	O chamador não tem o acesso apropriado para concluir a operação. Para obter uma lista dos tipos de acesso necessários, consulte a descrição do parâmetro InformationClass .
STATUS_INSUFFICIENT_ RECURSOS	Recursos insuficientes do sistema, como memória, para concluir a chamada.

Você pode usar a função LsaNtStatusToWinError para converter o valor NTSTATUS em um código de erro do Windows.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntsecapi.h
Biblioteca	Advapi32.lib
DLL	Advapi32.dll

Confira também

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS

Compartilhar via