CredReadA-Funktion (wincred.h)

Die CredRead--Funktion liest eine Anmeldeinformation aus dem Anmeldeinformationssatz des Benutzers vor. 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 CredReadA(
  [in]  LPCSTR       TargetName,
  [in]  DWORD        Type,
  [in]  DWORD        Flags,
  [out] PCREDENTIALA *Credential
);

Parameter

[in] TargetName

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen der zu lesenden Anmeldeinformationen enthält.

[in] Type

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

[in] Flags

Derzeit reserviert und muss null sein.

[out] Credential

Zeigen Sie 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 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:

• ERROR_NOT_FOUND

  Es sind keine Anmeldeinformationen mit dem angegebenen TargetName-vorhanden.

• ERROR_NO_SUCH_LOGON_SESSION

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

• ERROR_INVALID_FLAGS

  Ein ungültiges Kennzeichen wurde für den parameter Flags angegeben.

Bemerkungen

Wenn der Wert des Type Member der CREDENTIAL- Struktur, die durch den Parameter Credential angegeben wird, CRED_TYPE_DOMAIN_EXTENDEDist, muss ein Namespace im Zielnamen angegeben werden. Diese Funktion kann nur eine Anmeldeinformation des angegebenen Typs zurückgeben.

Anforderungen