CredEnumerateA, fonction (wincred.h)

La fonction CredEnumerate énumère les informations d’identification de l’ensemble d’informations d’identification de l’utilisateur. Le jeu d’informations d’identification utilisé est celui associé à la session d’ouverture de session du jeton actuel. Le jeton ne doit pas avoir le SID de l’utilisateur désactivé.

Syntaxe

BOOL CredEnumerateA(
  [in]  LPCSTR       Filter,
  [in]  DWORD        Flags,
  [out] DWORD        *Count,
  [out] PCREDENTIALA **Credential
);

Paramètres

[in] Filter

Pointeur vers une chaîne null-terminated qui contient le filtre pour les informations d’identification retournées. Seules les informations d’identification avec un TargetName correspondant au filtre sont retournées. Le filtre spécifie un préfixe de nom suivi d’un astérisque. Par exemple, le filtre « FRED* » retourne toutes les informations d’identification avec un TargetName commençant par la chaîne « FRED ».

Si NULL est spécifié, toutes les informations d’identification sont retournées.

[in] Flags

La valeur de ce paramètre peut être égale à zéro ou plusieurs des valeurs suivantes combinées à une opération deOU au niveau du bit.

Valeur

Signification

CRED_ENUMERATE_ALL_CREDENTIALS 0x1

Cette fonction énumère toutes les informations d’identification dans le jeu d’informations d’identification de l’utilisateur. Le nom cible de chaque informations d’identification est retourné au format « namespace :attribute=target ». Si cet indicateur est défini et que le paramètre Filter n’est pas NULL, la fonction échoue et retourne ERROR_INVALID_FLAGS. Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge.

[out] Count

Nombre des informations d’identification retournées dans le tableau Informations d’identification.

[out] Credential

Pointeur vers un tableau de pointeurs vers les informations d’identification. Les informations d’identification retournées sont un bloc alloué unique. Tous les pointeurs contenus dans la mémoire tampon sont des pointeurs vers des emplacements au sein de ce bloc alloué unique. La mémoire tampon retournée unique doit être libérée en appelant CredFree.

Valeur de retour

La fonction retourne TRUE en cas de réussite et FAUX en cas d’échec. La fonction GetLastError peut être appelée pour obtenir un code d’état plus spécifique. Les codes d’état suivants peuvent être retournés.

Retourner le code/la valeur	Description
ERROR_NOT_FOUND 1168 (0x490)	Aucune information d’identification n’existe correspondant aude filtre spécifié.
ERROR_NO_SUCH_LOGON_SESSION 1312 (0x520)	La session d’ouverture de session n’existe pas ou il n’existe aucun jeu d’informations d’identification associé à cette session d’ouverture de session. Les sessions d’ouverture de session réseau n’ont pas d’ensemble d’informations d’identification associées.
ERROR_INVALID_FLAGS 1004 (0x3EC)	Un indicateur qui n’est pas valide a été spécifié pour le paramètre indicateurs de , ou CRED_ENUMERATE_ALL_CREDENTIALS est spécifié pour le paramètre indicateurs de et le paramètre filtre n’est pas NULL.

Remarques

Note

L’en-tête wincred.h définit CredEnumerate comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wincred.h
bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

CredFree

GetLastError