Fonction LsaEnumerateTrustedDomainsEx (ntsecapi.h)
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 |
|---|---|
|
L’appelant ne dispose pas de l’accès approprié pour terminer l’opération. |
|
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 |