Fonction LsaQueryTrustedDomainInfoByName (ntsecapi.h)

Article
08/25/2023

La fonction LsaQueryTrustedDomainInfoByName retourne des informations sur un domaine approuvé.

Syntaxe

NTSTATUS LsaQueryTrustedDomainInfoByName(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PLSA_UNICODE_STRING       TrustedDomainName,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

Paramètres

[in] PolicyHandle

Handle d’un objet Policy . Ce 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] TrustedDomainName

Chaîne qui contient le nom du domaine approuvé. Il peut s’agir du nom de domaine ou du nom plat.

[in] InformationClass

Spécifie le type d’informations à récupérer. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
TrustedDomainNameInformation	Nom du domaine approuvé.
TrustedPosixInformation	Décalage Posix du domaine approuvé.
TrustedPasswordInformation	Retourne le mot de passe du côté sortant de l’approbation.
TrustedDomainInformationBasic	Cette valeur n’est pas prise en charge.
TrustedDomainInformationEx	Informations d’approbation étendue, notamment les informations de base et le nom de domaine DNS, ainsi que les attributs relatifs à l’approbation.
TrustedDomainFullInformation	Informations complètes, y compris le décalage Posix et les informations d’authentification.

[out] Buffer

Reçoit un pointeur vers la mémoire tampon retournée qui contient les informations demandées. Le format et le contenu de cette mémoire tampon dépendent de la classe d’informations. Par exemple, si InformationClass est défini sur TrustedDomainInformationEx, Buffer reçoit un pointeur vers une structure TRUSTED_DOMAIN_INFORMATION_EX . Pour plus d’informations, consultez TRUSTED_INFORMATION_CLASS.

Une fois que vous avez terminé d’utiliser la mémoire tampon, libérez-la en appelant la fonction LsaFreeMemory .

Valeur retournée

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

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

Valeur	Description
STATUS_ACCESS_DENIED	L’appelant ne dispose pas de l’accès approprié pour terminer l’opération. Pour obtenir la liste des types d’accès requis, consultez la description du paramètre InformationClass .
ressources STATUS_INSUFFICIENT_	Ressources système insuffisantes, telles que la mémoire, pour terminer l’appel.

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

Voir aussi

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS

Partager via