Funzione CredReadA (wincred.h)

  • Articolo

La funzione CredRead legge una credenziale 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 disabilitato il SID dell'utente.

Sintassi

BOOL CredReadA(
  [in]  LPCSTR       TargetName,
  [in]  DWORD        Type,
  [in]  DWORD        Flags,
  [out] PCREDENTIALA *Credential
);

Parametri

[in] TargetName

Puntatore a una stringa con terminazione null contenente il nome della credenziale da leggere.

[in] Type

Tipo delle credenziali da leggere. Il 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. La funzione GetLastError può essere chiamata per ottenere un codice di stato più specifico. È possibile restituire i codici di stato seguenti:

  • ERROR_NOT_FOUND

    Nessuna credenziale esiste con 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 di rete non hanno un set di credenziali associato.

  • ERROR_INVALID_FLAGS

    Flag non valido per il parametro Flags .

Commenti

Se il valore del membro Type della struttura CREDENTIAL specificato dal parametro Credential è CRED_TYPE_DOMAIN_EXTENDED, è necessario specificare uno spazio dei nomi nel nome di destinazione. Questa funzione può restituire solo una credenziale del tipo specificato.

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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