Fonction LsaOpenTrustedDomainByName (ntsecapi.h)

Article
03/04/2024

La fonction LsaOpenTrustedDomainByName ouvre le handle de stratégie LSA d’un domaine approuvé distant. Vous pouvez passer ce handle aux appels de fonction LSA afin de définir ou d’interroger la stratégie LSA de l’ordinateur distant.

Syntaxe

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

Paramètres

[in] PolicyHandle

Handle d’un objet Policy . Il s’agit du handle de stratégie de l’ordinateur local. Pour plus d’informations, consultez Ouverture d’un handle d’objet de stratégie.

[in] TrustedDomainName

Nom du domaine approuvé. Ce nom peut être le nom plat ou le nom de domaine DNS (Domain Name System).

[in] DesiredAccess

Une structure ACCESS_MASK qui spécifie les autorisations d’accès demandées sur l’objet de domaine approuvé distant.

[out] TrustedDomainHandle

Pointeur qui reçoit l’adresse du handle de stratégie LSA du domaine approuvé distant. Vous pouvez passer ce handle aux appels de fonction LSA afin d’interroger et de gérer la stratégie LSA de l’ordinateur distant.

Lorsque votre application n’a plus besoin de ce handle, elle doit appeler LsaClose pour supprimer le handle.

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.

Valeur	Description
STATUS_ACCESS_DENIED	L’appelant ne dispose pas de l’accès approprié pour terminer l’opération.
STATUS_OBJECT_NAME_NOT_FOUND	Il n’existe aucun objet Domaine approuvé dans la base de données LSA du système cible portant le nom spécifié.

Vous pouvez utiliser la fonction LsaNtStatusToWinError pour convertir le code 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

LsaClose

Partager via