Función LsaQueryForestTrustInformation (ntsecapi.h)

  • Artículo

La función LsaQueryForestTrustInformation recupera información de confianza de bosque para el objeto TrustedDomain de la autoridad de seguridad local especificado.

Sintaxis

NTSTATUS LsaQueryForestTrustInformation(
  [in]  LSA_HANDLE                    PolicyHandle,
  [in]  PLSA_UNICODE_STRING           TrustedDomainName,
  [out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

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 para el que se va a recuperar la información de confianza del bosque.

[out] ForestTrustInfo

Puntero a una estructura de LSA_FOREST_TRUST_INFORMATION que devuelve la información de confianza del bosque para el objeto TrustedDomain especificado por el parámetro TrustedDomainName .

Valor devuelto

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

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

Código o valor devuelto Descripción
STATUS_INVALID_DOMAIN_ROLE
 La operación solo es legal en el controlador de dominio principal.
STATUS_INVALID_DOMAIN_STATE
 La operación solo es legal en los controladores de dominio del dominio raíz.
STATUS_NO_SUCH_DOMAIN
 El objeto TrustedDomain especificado no existe.
STATUS_NOT_FOUND
 El objeto TrustedDomain especificado no contiene información de confianza del bosque.

Comentarios

El acceso a esta función está protegido por un objeto protegible.

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