Funzione CredReadW (wincred.h)
La funzione CredRead legge 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 CredReadW(
[in] LPCWSTR TargetName,
[in] DWORD Type,
[in] DWORD Flags,
[out] PCREDENTIALW *Credential
);
Parametri
[in] TargetName
Puntatore a una stringa con terminazione Null che contiene il nome della credenziale da leggere.
[in] Type
Tipo di credenziale da leggere. Tipo deve essere uno dei tipi definiti CRED_TYPE_*.
[in] Flags
Attualmente riservato e deve essere zero.
[out] Credential
Puntatore a un singolo buffer di blocchi allocato per restituire le credenziali. 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
- ERROR_NOT_FOUND
Non esiste alcuna credenziale con il TargetName specificato.
- ERROR_NO_SUCH_LOGON_SESSION
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
Flag non valido specificato per il parametro flag
.
Osservazioni
Se il valore del membro di
Nota
L'intestazione wincred.h definisce CredRead 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 |