CredEnumerateA-Funktion (wincred.h)

Die CredEnumerate-Funktion listet die Anmeldeinformationen aus dem Anmeldeinformationssatz des Benutzers auf. Der verwendete Anmeldeinformationssatz ist der Der Anmeldeinformationssatz, der der Anmeldesitzung des aktuellen Tokens zugeordnet ist. Das Token darf die SID des Benutzers nicht deaktiviert haben.

Syntax

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

Parameter

[in] Filter

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den Filter für die zurückgegebenen Anmeldeinformationen enthält. Es werden nur Anmeldeinformationen mit einem TargetName zurückgegeben, der dem Filter entspricht. Der Filter gibt ein Namenspräfix gefolgt von einem Sternchen an. Beispielsweise gibt der Filter "FRED*" alle Anmeldeinformationen mit einem TargetName- ab der Zeichenfolge "FRED" zurück.

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 bitweisenODER--Vorgang.

[out] Count

Die Anzahl der im Array "Anmeldeinformationen" zurückgegebenen Anmeldeinformationen.

[out] Credential

Zeigen Sie auf ein Array von Zeigern auf Anmeldeinformationen. Die zurückgegebenen Anmeldeinformationen sind ein einzelner zugewiesener Block. Alle im Puffer enthaltenen Zeiger sind Zeiger auf Positionen innerhalb dieses einzelnen zugeordneten Blocks. Der einzelne zurückgegebene Puffer muss durch Aufrufen von CredFreefreigegeben werden.

Rückgabewert

Die Funktion gibt TRUE bei Erfolg zurück und FALSE- bei Fehlern. Die GetLastError--Funktion kann aufgerufen werden, um einen spezifischeren Statuscode abzurufen. Die folgenden Statuscodes können zurückgegeben werden.

Bemerkungen

Anforderungen

Siehe auch

CredFree-

GetLastError-