Fonction LsaEnumerateTrustedDomainsEx (ntsecapi.h)

Article
03/09/2024

La fonction LsaEnumerateTrustedDomainsEx retourne des informations sur les domaines approuvés par le système local. LsaEnumerateTrustedDomainsEx retourne des informations uniquement sur les approbations directes. DsEnumerateDomainTrusts est recommandé pour une énumération d’approbation plus complète.

Syntaxe

NTSTATUS LsaEnumerateTrustedDomainsEx(
  [in]  LSA_HANDLE              PolicyHandle,
  [in]  PLSA_ENUMERATION_HANDLE EnumerationContext,
  [out] PVOID                   *Buffer,
  [in]  ULONG                   PreferedMaximumLength,
  [out] PULONG                  CountReturned
);

Paramètres

[in] PolicyHandle

Handle d’un objet Policy . Cet appel nécessite POLICY_VIEW_LOCAL_INFORMATION accès à l’objet Policy . Pour plus d’informations, consultez Ouverture d’un handle d’objet de stratégie.

[in] EnumerationContext

Pointeur vers un LSA_ENUMERATION_HANDLE que vous pouvez utiliser pour effectuer plusieurs appels à LsaEnumerateTrustedDomainsEx pour récupérer toutes les informations de domaine approuvé. Pour plus d'informations, consultez la section Notes.

[out] Buffer

Pointeur vers une mémoire tampon qui reçoit une liste de structures TRUSTED_DOMAIN_INFORMATION_EX qui contiennent des informations sur les domaines approuvés énumérés.

Votre application doit libérer cette mémoire tampon quand elle n’est plus nécessaire en appelant LsaFreeMemory.

[in] PreferedMaximumLength

Longueur maximale préférée, en octets, des données retournées. Il ne s’agit pas d’une limite supérieure difficile, mais sert de guide. En raison de la conversion des données entre des systèmes avec des tailles de données naturelles différentes, la quantité réelle de données retournées peut être supérieure à cette valeur.

[out] CountReturned

Pointeur vers un LONG qui reçoit le nombre d’objets de domaine approuvés retournés.

Valeur retournée

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

Si la fonction échoue, elle retourne 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_NO_MORE_ENTRIES	Il n’y a plus d’entrées. Cet avertissement est retourné si aucun objet n’a été énuméré, car la valeur EnumerationContext est trop élevée.

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

Remarques

La récupération de toutes les informations d’approbation peut nécessiter plusieurs appels LsaEnumerateTrustedDomainsEx .

Pour utiliser le paramètre ÉnumérationContext pour effectuer plusieurs appels

Définissez la variable pointée vers ÉnumérationContext sur zéro.
Si LsaEnumerateTrustedDomainsEx retourne STATUS_SUCCESS ou STATUS_MORE_ENTRIES, appelez à nouveau la fonction, en passant la valeur EnumerationContext retournée par l’appel précédent.
L’énumération est terminée lorsque la fonction retourne STATUS_NO_MORE_ENTRIES.

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

LSA_ENUMERATION_HANDLE

LsaFreeMemory

TRUSTED_DOMAIN_INFORMATION_EX

Partager via