Partager via


LsaQueryForestTrustInformation, fonction (ntsecapi.h)

La fonction LsaQueryForestTrustInformation récupère les informations d’approbation de forêt pour l’objet TrustedDomain del’autorité de sécurité locale spécifiée.

Syntaxe

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

Paramètres

[in] PolicyHandle

Handle de l’objet Policy pour le système.

[in] TrustedDomainName

Pointeur vers une structure LSA_UNICODE_STRING qui contient le nom de l’objet TrustedDomain pour lequel récupérer des informations d’approbation de forêt.

[out] ForestTrustInfo

Pointeur vers une structure LSA_FOREST_TRUST_INFORMATION qui retourne les informations d’approbation de forêt pour l’objet TrustedDomain spécifié par le paramètre TrustedDomainName .

Valeur retournée

Si la fonction réussit, la valeur de retour est STATUS_SUCCESS.

Si la fonction échoue, la valeur de retour est un code NTSTATUS, qui peut être l’une des valeurs suivantes ou l’une des valeurs de retour de la fonction de stratégie LSA.

Code/valeur de retour Description
STATUS_INVALID_DOMAIN_ROLE
L’opération est légale uniquement sur le contrôleur de domaine principal.
STATUS_INVALID_DOMAIN_STATE
L’opération est légale uniquement sur les contrôleurs de domaine dans le domaine racine.
STATUS_NO_SUCH_DOMAIN
L’objet TrustedDomain spécifié n’existe pas.
STATUS_NOT_FOUND
L’objet TrustedDomain spécifié ne contient pas d’informations d’approbation de forêt.

Remarques

L’accès à cette fonction est protégé par un objet sécurisable.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ntsecapi.h
Bibliothèque Advapi32.lib
DLL Advapi32.dll