Partager via


Fonction LsaQueryTrustedDomainInfoByName (ntsecapi.h)

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