CredUnmarshalCredentialA-Funktion (wincred.h)

Artikel
11/20/2024

Die CredUnmarshalCredential--Funktion wandelt die gemarsteten Anmeldeinformationen wieder in die ursprüngliche Form um.

Syntax

BOOL CredUnmarshalCredentialA(
  [in]  LPCSTR             MarshaledCredential,
  [out] PCRED_MARSHAL_TYPE CredType,
  [out] PVOID              *Credential
);

Parameter

[in] MarshaledCredential

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die die gemarsteten Anmeldeinformationen enthält.

[out] CredType

Typ der anmeldeinformationen angegeben durch MarshaledCredential.

Dies ist einer der CRED_MARSHAL_TYPE Werte.

[out] Credential

Zeigen Sie auf die nichtmarsierten Anmeldeinformationen. Wenn CredTypeCertCredential-zurückgibt, ist der zurückgegebene Zeiger auf eine CERT_CREDENTIAL_INFO Struktur. Wenn CredTypeUsernameTargetCredential-zurückgibt, liegt der zurückgegebene Zeiger auf einer USERNAME_TARGET_CREDENTIAL_INFO Struktur.

Der Aufrufer sollte den zurückgegebenen Puffer mit CredFreefreigeben.

Rückgabewert

Diese Funktion gibt TRUE bei Erfolg zurück und FALSE- bei Fehlern. Die GetLastError--Funktion kann aufgerufen werden, um einen spezifischeren Statuscode abzurufen. Der folgende Statuscode kann zurückgegeben werden:

ERROR_INVALID_PARAMETER

MarshaledCredential ungültig ist.

Bemerkungen

Anmerkung

Der wincred.h-Header definiert CredUnmarshalCredential 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wincred.h
Library	Advapi32.lib
DLL-	Advapi32.dll