Freigeben über

CredGetSessionTypes-Funktion (wincred.h)

  • Artikel

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