Compartilhar via


Função LsaSetForestTrustInformation (ntsecapi.h)

A função LsaSetForestTrustInformation define as informações de confiança da floresta para um objeto TrustedDomain da Autoridade de Segurança Local especificado.

Sintaxe

NTSTATUS LsaSetForestTrustInformation(
  [in]  LSA_HANDLE                              PolicyHandle,
  [in]  PLSA_UNICODE_STRING                     TrustedDomainName,
  [in]  PLSA_FOREST_TRUST_INFORMATION           ForestTrustInfo,
  [in]  BOOLEAN                                 CheckOnly,
  [out] PLSA_FOREST_TRUST_COLLISION_INFORMATION *CollisionInfo
);

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 definir as informações de confiança da floresta especificadas pelo parâmetro ForestTrustInfo .

[in] ForestTrustInfo

Ponteiro para uma estrutura LSA_FOREST_TRUST_INFORMATION que contém as informações de confiança da floresta a serem definidas como o objeto TrustedDomain especificado pelo parâmetro TrustedDomainName .

[in] CheckOnly

Valor booliano que especifica se as alterações no objeto TrustedDomain são persistentes. Se esse valor for TRUE, essa função marcar para colisões com os parâmetros especificados, mas não definirá as informações de confiança da floresta especificadas pelo parâmetro ForestTrustInfo para o objeto TrustedDomain especificado pelo parâmetro TrustedDomainName. Se esse valor for FALSE, as informações de confiança da floresta serão definidas como o objeto TrustedDomain .

[out] CollisionInfo

Ponteiro para um ponteiro para uma estrutura LSA_FOREST_TRUST_COLLISION_INFORMATION que retorna informações sobre quaisquer colisões que ocorreram.

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_STATE
A operação é legal somente em controladores de domínio no domínio raiz.
STATUS_INVALID_DOMAIN_ROLE
A operação é legal somente no controlador de domínio primário.

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