CredEnumerateA-Funktion (wincred.h)

  • Artikel

Die CredEnumerate-Funktion listet die Anmeldeinformationen aus dem Anmeldeinformationssatz des Benutzers auf. Bei dem verwendeten Anmeldeinformationssatz handelt es sich um den Satz, der der Anmeldesitzung des aktuellen Tokens zugeordnet ist. Für das Token darf die SID des Benutzers nicht deaktiviert sein.

Syntax

BOOL CredEnumerateA(
  [in]  LPCSTR       Filter,
  [in]  DWORD        Flags,
  [out] DWORD        *Count,
  [out] PCREDENTIALA **Credential
);

Parameter

[in] Filter

Zeiger auf eine NULL-endende Zeichenfolge, die den Filter für die zurückgegebenen Anmeldeinformationen enthält. Es werden nur Anmeldeinformationen zurückgegeben, deren TargetName dem Filter entspricht. Der Filter gibt ein Namenspräfix gefolgt von einem Sternchen an. Für instance gibt der Filter "FRED*" alle Anmeldeinformationen mit einem TargetName-Wert zurück, der mit der Zeichenfolge "FRED" beginnt.

Wenn NULL angegeben ist, werden alle Anmeldeinformationen zurückgegeben.

[in] Flags

Der Wert dieses Parameters kann null oder mehr der folgenden Werte sein, kombiniert mit einem bitweisen OR-Vorgang .

Wert Bedeutung
CRED_ENUMERATE_ALL_CREDENTIALS
0x1
 Diese Funktion listet alle Anmeldeinformationen im Anmeldeinformationssatz des Benutzers auf. Der Zielname jeder Anmeldeinformation wird im Format "namespace:attribute=target" zurückgegeben. Wenn dieses Flag festgelegt ist und der Filter-Parameter nicht NULL ist, schlägt die Funktion fehl und gibt ERROR_INVALID_FLAGS zurück.

Windows Server 2003 und Windows XP: Dieses Flag wird nicht unterstützt.

[out] Count

Anzahl der im Anmeldeinformationsarray zurückgegebenen Anmeldeinformationen.

[out] Credential

Zeiger auf ein Array von Zeigern auf Anmeldeinformationen. Die zurückgegebenen Anmeldeinformationen sind ein einzelner zugeordneter Block. Alle im Puffer enthaltenen Zeiger sind Zeiger auf Speicherorte innerhalb dieses einzelnen zugeordneten Blocks. Der einzelne zurückgegebene Puffer muss durch Aufrufen von CredFree freigegeben werden.

Rückgabewert

Die Funktion gibt TRUE bei Erfolg und FALSE bei Einem Fehler zurück. Die GetLastError-Funktion kann aufgerufen werden, um einen spezifischeren status Code abzurufen. Die folgenden status Codes können zurückgegeben werden.

Rückgabecode/-wert BESCHREIBUNG
ERROR_NOT_FOUND
1168 (0x490)
 Es sind keine Anmeldeinformationen vorhanden, die dem angegebenen Filter entsprechen.
ERROR_NO_SUCH_LOGON_SESSION
1312 (0x520)
 Die Anmeldesitzung ist nicht vorhanden, oder dieser Anmeldesitzung ist kein Anmeldeinformationssatz zugeordnet. Netzwerkanmeldungssitzungen verfügen nicht über einen zugeordneten Anmeldeinformationssatz.
ERROR_INVALID_FLAGS
1004 (0x3EC)
 Für den Flags-Parameter wurde ein ungültiges Flag angegeben, oder für den Flags-Parameter wurde CRED_ENUMERATE_ALL_CREDENTIALS angegeben, und der Filter-Parameter ist nicht NULL.

Hinweise

Hinweis

Der wincred.h-Header definiert CredEnumerate als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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

Weitere Informationen

CredFree

GetLastError