LsaQueryForestTrustInformation, fonction (ntsecapi.h)

Article
02/29/2024

La fonction LsaQueryForestTrustInformation récupère les informations d’approbation de forêt pour l’objet TrustedDomain de l’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

Share via