Funzione CredGetSessionTypes (wincred.h)

  • Articolo

La funzione CredGetSessionTypes restituisce la persistenza massima supportata dalla sessione di accesso corrente. Per ogni tipo di credenziale viene restituita una persistenza massima separata.

Sintassi

BOOL CredGetSessionTypes(
  [in]  DWORD   MaximumPersistCount,
  [out] LPDWORD MaximumPersist
);

Parametri

[in] MaximumPersistCount

Numero di elementi nella matrice MaximumPersist . Usare CRED_TYPE_MAXIMUM per restituire tutti i tipi di credenziali attualmente definiti.

[out] MaximumPersist

Puntatore a una matrice in cui restituire i valori di persistenza. La matrice passata deve essere elementi MaximumPersistCount lunghi. In caso di restituzione, ogni elemento specifica la persistenza massima supportata dal tipo di credenziale corrispondente.

Il chiamante deve usare una delle definizioni seguenti per indicizzare nella matrice:

  • CRED_TYPE_GENERIC
  • CRED_TYPE_DOMAIN_PASSWORD
  • CRED_TYPE_DOMAIN_CERTIFICATE
Ovvero MaximumPersist[CRED_TYPE_GENERIC] specifica la persistenza massima supportata per le credenziali generiche.

I valori seguenti possono essere restituiti in ogni elemento della matrice.

Valore Significato
CRED_PERSIST_NONE
 Non è possibile archiviare credenziali. Questo valore verrà restituito se il tipo di credenziale non è supportato o è stato disabilitato dai criteri.
CRED_PERSIST_SESSION
 È possibile archiviare solo credenziali specifiche della sessione.
CRED_PERSIST_LOCAL_MACHINE
 È possibile archiviare credenziali specifiche della sessione e specifiche del computer.

Windows XP: Questa credenziale non può essere archiviata per le sessioni in cui il profilo non viene caricato.
CRED_PERSIST_ENTERPRISE
 È possibile archiviare qualsiasi credenziale.

Windows XP: Questa credenziale non può essere archiviata per le sessioni in cui il profilo non viene caricato.

Valore restituito

Questa 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 il codice di stato seguente:

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.

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