Funzione CredEnumerateA (wincred.h)

Articolo
08/27/2023

La funzione CredEnumerate enumera le credenziali dal set di credenziali dell'utente. Il set di credenziali usato è quello associato alla sessione di accesso del token corrente. Il token non deve avere il SID dell'utente disabilitato.

Sintassi

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

Parametri

[in] Filter

Puntatore a una stringa con terminazione Null contenente il filtro per le credenziali restituite. Verranno restituite solo le credenziali con targetName corrispondente al filtro. Il filtro specifica un prefisso del nome seguito da un asterisco. Ad esempio, il filtro "FRED*" restituirà tutte le credenziali con targetName che inizia con la stringa "FRED".

Se viene specificato NULL , verranno restituite tutte le credenziali.

[in] Flags

Il valore di questo parametro può essere zero o più dei valori seguenti combinati con un'operazione OR bit per bit.

Valore	Significato
CRED_ENUMERATE_ALL_CREDENTIALS 0x1	Questa funzione enumera tutte le credenziali nel set di credenziali dell'utente. Il nome di destinazione di ogni credenziale viene restituito nel formato "namespace:attribute=target". Se questo flag è impostato e il parametro Filter non è NULL, la funzione ha esito negativo e restituisce ERROR_INVALID_FLAGS. Windows Server 2003 e Windows XP: Questo flag non è supportato.

[out] Count

Conteggio delle credenziali restituite nella matrice Credentials .

[out] Credential

Puntatore a una matrice di puntatori alle credenziali. La credenziale restituita è un singolo blocco allocato. Tutti i puntatori contenuti nel buffer sono puntatori a posizioni all'interno di questo singolo blocco allocato. Il singolo buffer restituito deve essere liberato chiamando CredFree.

Valore restituito

La funzione restituisce TRUE in caso di esito positivo e FALSE in caso di errore. È possibile chiamare la funzione GetLastError per ottenere un codice di stato più specifico. È possibile restituire i codici di stato seguenti.

Codice/valore restituito	Descrizione
ERROR_NOT_FOUND 1168 (0x490)	Nessuna credenziale corrispondente al filtro specificato.
ERROR_NO_SUCH_LOGON_SESSION 1312 (0x520)	La sessione di accesso non esiste o non esiste alcun set di credenziali associato a questa sessione di accesso. Le sessioni di accesso di rete non hanno un set di credenziali associato.
ERROR_INVALID_FLAGS 1004 (0x3EC)	È stato specificato un flag non valido per il parametro Flags oppure CRED_ENUMERATE_ALL_CREDENTIALS viene specificato per il parametro Flags e il parametro Filter non è NULL.

Commenti

Nota

L'intestazione wincred.h definisce CredEnumerate come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wincred.h
Libreria	Advapi32.lib
DLL	Advapi32.dll

Vedi anche

CredFree

Getlasterror