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 |
---|---|
|
A operação é legal somente no controlador de domínio primário. |
|
A operação é legal somente em controladores de domínio no domínio raiz. |
|
O objeto TrustedDomain especificado não existe. |
|
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 |