Función LsaSetForestTrustInformation (ntsecapi.h)

La función LsaSetForestTrustInformation establece la información de confianza del bosque para un objeto TrustedDomain de autoridad de seguridad local especificado.

Sintaxis

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

Identificador del objeto Policy del sistema.

[in] TrustedDomainName

Puntero a una estructura de LSA_UNICODE_STRING que contiene el nombre del objeto TrustedDomain en el que se va a establecer la información de confianza del bosque especificada por el parámetro ForestTrustInfo .

[in] ForestTrustInfo

Puntero a una estructura de LSA_FOREST_TRUST_INFORMATION que contiene la información de confianza del bosque que se va a establecer en el objeto TrustedDomain especificado por el parámetro TrustedDomainName .

[in] CheckOnly

Valor booleano que especifica si se conservan los cambios en el objeto TrustedDomain . Si este valor es TRUE, esta función comprobará las colisiones con los parámetros especificados, pero no establecerá la información de confianza del bosque especificada por el parámetro ForestTrustInfo en el objeto TrustedDomain especificado por el parámetro TrustedDomainName . Si este valor es FALSE, la información de confianza del bosque se establecerá en el objeto TrustedDomain .

[out] CollisionInfo

Puntero a un puntero a una estructura de LSA_FOREST_TRUST_COLLISION_INFORMATION que devuelve información sobre las colisiones que se produjeron.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es STATUS_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código NTSTATUS, que puede ser uno de los siguientes valores o uno de los valores devueltos de la función de directiva LSA.

Código o valor devuelto	Descripción
STATUS_INVALID_DOMAIN_STATE	La operación solo es legal en los controladores de dominio del dominio raíz.
STATUS_INVALID_DOMAIN_ROLE	La operación solo es legal en el controlador de dominio principal.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ntsecapi.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll