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