Fonction LsaQueryTrustedDomainInfo (ntsecapi.h)

Article
08/25/2023

La fonction LsaQueryTrustedDomainInfo récupère des informations sur un domaine approuvé.

Syntaxe

NTSTATUS LsaQueryTrustedDomainInfo(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PSID                      TrustedDomainSid,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

Paramètres

[in] PolicyHandle

Handle de l’objet Policy d’un contrôleur de domaine qui a une relation d’approbation avec le domaine identifié par le paramètre TrustedDomainSid . Le handle doit avoir le droit d’accès POLICY_VIEW_LOCAL_INFORMATION. Pour plus d’informations, consultez Ouverture d’un handle d’objet de stratégie.

[in] TrustedDomainSid

Pointeur vers le SID du domaine approuvé à interroger.

[in] InformationClass

Spécifie l’une des valeurs suivantes du type d’énumération TRUSTED_INFORMATION_CLASS . La valeur indique le type d’informations demandées.

Valeur	Signification
TrustedDomainNameInformation	Récupère le nom du domaine approuvé. Le paramètre Buffer reçoit un pointeur vers une structure TRUSTED_DOMAIN_NAME_INFO .
TrustedPosixOffsetInformation	Récupère la valeur utilisée pour générer des identificateurs d’utilisateur et de groupe Posix pour le domaine approuvé. Le paramètre Buffer reçoit un pointeur vers une structure TRUSTED_POSIX_OFFSET_INFO .
TrustedPasswordInformation	Récupère le mot de passe du domaine approuvé. Le paramètre Buffer reçoit un pointeur vers une structure TRUSTED_PASSWORD_INFO . Le handle transmis dans le paramètre PolicyHandle doit avoir le droit d’accès POLICY_GET_PRIVATE_INFORMATION.
TrustedDomainInformationEx	Récupère des informations étendues pour le domaine approuvé. Le paramètre Buffer reçoit un pointeur vers une structure TRUSTED_DOMAIN_INFORMATION_EX .
TrustedDomainInformationBasic	Cette valeur n’est pas prise en charge.
TrustedDomainFullInformation	Récupère des informations complètes pour le domaine approuvé. Ces informations incluent les informations de décalage Posix, les informations d’authentification et les informations étendues retournées pour la valeur TrustedDomainInformationEx. Le paramètre Buffer reçoit un pointeur vers une structure TRUSTED_DOMAIN_FULL_INFORMATION .

[out] Buffer

Pointeur vers une mémoire tampon qui reçoit un pointeur vers une structure qui contient les informations demandées. Le type de structure dépend de la valeur du paramètre InformationClass .

Lorsque vous avez terminé d’utiliser les informations, libérez le pointeur retourné en le transmettant à LsaFreeMemory.

Valeur retournée

Si la fonction réussit, la fonction retourne STATUS_SUCCESS.

Si la fonction échoue, elle retourne une valeur NTSTATUS qui indique l’erreur. Pour plus d’informations, consultez Valeurs de retour de la fonction de stratégie LSA.

Vous pouvez utiliser la fonction LsaNtStatusToWinError pour convertir la valeur NTSTATUS en code d’erreur Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
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