Funzione CredEnumerateA (wincred.h)

Articolo
11/20/2024

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 un nullstringa con terminazione contenente il filtro per le credenziali restituite. Verranno restituite solo le credenziali con un 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 un TargetName che inizia con la stringa "FRED".

Se si specifica 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 diOR 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 credenziali .

[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 all'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 alla rete non hanno un set di credenziali associato.
ERROR_INVALID_FLAGS 1004 (0x3EC)	È stato specificato un flag non valido per il parametro flag oppure CRED_ENUMERATE_ALL_CREDENTIALS viene specificato per il parametro Flag e il parametro Filter non è NULL.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wincred.h
libreria	Advapi32.lib
dll	Advapi32.dll

Vedere anche

CredFree

GetLastError

Condividi tramite