Compartir a través de


Función LsaQueryForestTrustInformation (ntsecapi.h)

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

Syntax

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 para el 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 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 y valor devueltos Description
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.

Observaciones

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

Requisitos

Requirement Importancia
Cliente mínimo compatible No se admite ninguno
Servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
Header ntsecapi.h
Library Advapi32.lib
DLL de Advapi32.dll