CredGetSessionTypes-Funktion (wincred.h)

Artikel
03/03/2024

Die CredGetSessionTypes-Funktion gibt die maximale Persistenz zurück, die von der aktuellen Anmeldesitzung unterstützt wird. Für jeden Anmeldeinformationstyp wird eine separate maximale Persistenz zurückgegeben.

Syntax

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

Parameter

[in] MaximumPersistCount

Anzahl der Elemente im MaximumPersist-Array . Verwenden Sie CRED_TYPE_MAXIMUM, um alle derzeit definierten Anmeldeinformationstypen zurückzugeben.

[out] MaximumPersist

Zeiger auf ein Array, um die Persistenzwerte zurückzugeben. Das übergebene Array sollte MaximalPersistCount-Elemente lang sein. Bei der Rückgabe gibt jedes Element die maximale Persistenz an, die vom entsprechenden Anmeldeinformationstyp unterstützt wird.

Der Aufrufer sollte eine der folgenden Definitionen verwenden, um in das Array zu indizieren:

CRED_TYPE_GENERIC
CRED_TYPE_DOMAIN_PASSWORD
CRED_TYPE_DOMAIN_CERTIFICATE

Das heißt, MaximumPersist[CRED_TYPE_GENERIC] gibt die maximale Persistenz an, die für generische Anmeldeinformationen unterstützt wird.

Die folgenden Werte können in jedem Element des Arrays zurückgegeben werden.

Wert	Bedeutung
CRED_PERSIST_NONE	Es können keine Anmeldeinformationen gespeichert werden. Dieser Wert wird zurückgegeben, wenn der Anmeldeinformationstyp nicht unterstützt wird oder von der Richtlinie deaktiviert wurde.
CRED_PERSIST_SESSION	Es können nur sitzungsspezifische Anmeldeinformationen gespeichert werden.
CRED_PERSIST_LOCAL_MACHINE	Sitzungsspezifische und computerspezifische Anmeldeinformationen können gespeichert werden. Windows XP: Diese Anmeldeinformationen können nicht für Sitzungen gespeichert werden, in denen das Profil nicht geladen wird.
CRED_PERSIST_ENTERPRISE	Alle Anmeldeinformationen können gespeichert werden. Windows XP: Diese Anmeldeinformationen können nicht für Sitzungen gespeichert werden, in denen das Profil nicht geladen wird.

Rückgabewert

Diese Funktion gibt TRUE bei erfolg und FALSE bei Fehler zurück. Die GetLastError-Funktion kann aufgerufen werden, um einen spezifischeren status Code abzurufen. Der folgende status Code kann zurückgegeben werden:

ERROR_NO_SUCH_LOGON_SESSION

Die Anmeldesitzung ist nicht vorhanden, oder dieser Anmeldesitzung sind keine Anmeldeinformationen zugeordnet. Netzwerkanmeldungssitzungen verfügen nicht über einen zugeordneten Anmeldeinformationssatz.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincred.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Freigeben über