Fonction CredGetSessionTypes (wincred.h)

Article
03/06/2024

La fonction CredGetSessionTypes retourne la persistance maximale prise en charge par la session d’ouverture de session active. Une persistance maximale distincte est retournée pour chaque type d’informations d’identification.

Syntaxe

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

Paramètres

[in] MaximumPersistCount

Nombre d’éléments dans le tableau MaximumPersist . Utilisez CRED_TYPE_MAXIMUM pour retourner tous les types d’informations d’identification actuellement définis.

[out] MaximumPersist

Pointeur vers un tableau dans lequel retourner les valeurs de persistance. Le passé dans le tableau doit être des éléments MaximumPersistCount longs. Au retour, chaque élément spécifie la persistance maximale prise en charge par le type d’informations d’identification correspondant.

L’appelant doit utiliser l’une des définitions suivantes pour indexer dans le tableau :

CRED_TYPE_GENERIC
CRED_TYPE_DOMAIN_PASSWORD
CRED_TYPE_DOMAIN_CERTIFICATE

Autrement dit, MaximumPersist[CRED_TYPE_GENERIC] spécifie la persistance maximale prise en charge pour les informations d’identification génériques.

Les valeurs suivantes peuvent être retournées dans chaque élément du tableau.

Valeur	Signification
CRED_PERSIST_NONE	Aucune information d’identification ne peut être stockée. Cette valeur est retournée si le type d’informations d’identification n’est pas pris en charge ou a été désactivé par la stratégie.
CRED_PERSIST_SESSION	Seules les informations d’identification spécifiques à la session peuvent être stockées.
CRED_PERSIST_LOCAL_MACHINE	Les informations d’identification spécifiques à la session et à l’ordinateur peuvent être stockées. Windows XP : Ces informations d’identification ne peuvent pas être stockées pour les sessions dans lesquelles le profil n’est pas chargé.
CRED_PERSIST_ENTERPRISE	Toutes les informations d’identification peuvent être stockées. Windows XP : Ces informations d’identification ne peuvent pas être stockées pour les sessions dans lesquelles le profil n’est pas chargé.

Valeur retournée

Cette fonction retourne TRUE en cas de réussite et FALSE en cas d’échec. La fonction GetLastError peut être appelée pour obtenir un code status plus spécifique. Le code status suivant peut être retourné :

ERROR_NO_SUCH_LOGON_SESSION

La session d’ouverture de session n’existe pas ou aucun jeu d’informations d’identification n’est associé à cette session d’ouverture de session. Les sessions d’ouverture de session réseau n’ont pas d’ensemble d’informations d’identification associées.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wincred.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Share via