Função LsaQueryTrustedDomainInfoByName (ntsecapi.h)

  • Artigo

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