Partilhar 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 de LSA_FOREST_TRUST_INFORMATION que contém as informações de confiança da floresta a serem definidas para o objeto TrustedDomain especificado pelo parâmetro TrustedDomainName .

[in] CheckOnly

Valor booliano que especifica se as alterações no objeto TrustedDomain são mantidas. Se esse valor for TRUE, essa função verificará 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.

Valor de retorno

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 seguintes valores ou um dos valores retornados da função de política LSA.

Código/valor de retorno Description
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.

Requirements

Requirement Value
Cliente mínimo suportado Nenhum compatível
Servidor mínimo compatível Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header ntsecapi.h
Library Advapi32.lib
de DLL Advapi32.dll