CredReadA-Funktion (wincred.h)

  • Artikel

Die CredRead-Funktion liest Anmeldeinformationen aus dem Anmeldeinformationssatz des Benutzers. Der verwendete Anmeldeinformationssatz ist der der Anmeldesitzung des aktuellen Tokens zugeordnet. Für das Token darf die SID des Benutzers nicht deaktiviert sein.

Syntax

BOOL CredReadA(
  [in]  LPCSTR       TargetName,
  [in]  DWORD        Type,
  [in]  DWORD        Flags,
  [out] PCREDENTIALA *Credential
);

Parameter

[in] TargetName

Zeiger auf eine NULL-Zeichenfolge, die den Namen der zu lesenden Anmeldeinformationen enthält.

[in] Type

Typ der zu lesenden Anmeldeinformationen. Typ muss einer der CRED_TYPE_* definierten Typen sein.

[in] Flags

Derzeit reserviert und muss null sein.

[out] Credential

Zeiger auf einen einzelnen zugeordneten Blockpuffer, um die Anmeldeinformationen zurückzugeben. Alle im Puffer enthaltenen Zeiger sind Zeiger auf Positionen 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 Fehler zurück. Die GetLastError-Funktion kann aufgerufen werden, um einen spezifischeren status Code abzurufen. Die folgenden status Codes können zurückgegeben werden:

  • ERROR_NOT_FOUND

    Mit dem angegebenen TargetName sind keine Anmeldeinformationen vorhanden.

  • 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.

  • ERROR_INVALID_FLAGS

    Für den Flags-Parameter wurde ein ungültiges Flag angegeben.

Hinweise

Wenn der Wert des Type-Members der CREDENTIAL-Struktur , die durch den Credential-Parameter angegeben wird , CRED_TYPE_DOMAIN_EXTENDED ist, muss im Zielnamen ein Namespace angegeben werden. Diese Funktion kann nur einen Anmeldeinformationen des angegebenen Typs zurückgeben.

Hinweis

Der wincred.h-Header definiert CredRead als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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