Função LsaQueryForestTrustInformation (ntsecapi.h)

A função LsaQueryForestTrustInformation recupera informações de confiança da floresta para o objeto TrustedDomain da Autoridade de Segurança Local especificado.

Sintaxe

NTSTATUS LsaQueryForestTrustInformation(
  [in]  LSA_HANDLE                    PolicyHandle,
  [in]  PLSA_UNICODE_STRING           TrustedDomainName,
  [out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

Parâmetros

[in] PolicyHandle

Um identificador para o objeto Policy para o sistema.

[in] TrustedDomainName

Ponteiro para uma estrutura LSA_UNICODE_STRING que contém o nome do objeto TrustedDomain para o qual recuperar informações de confiança da floresta.

[out] ForestTrustInfo

Ponteiro para uma estrutura LSA_FOREST_TRUST_INFORMATION que retorna as informações de confiança da floresta para o objeto TrustedDomain especificado pelo parâmetro TrustedDomainName .

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

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

Valor/código retornado	Descrição
STATUS_INVALID_DOMAIN_ROLE	A operação é legal somente no controlador de domínio primário.
STATUS_INVALID_DOMAIN_STATE	A operação é legal somente em controladores de domínio no domínio raiz.
STATUS_NO_SUCH_DOMAIN	O objeto TrustedDomain especificado não existe.
STATUS_NOT_FOUND	O objeto TrustedDomain especificado não contém informações de confiança da floresta.

Comentários

O acesso a essa função é protegido por um objeto protegível.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
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