CredUnmarshalCredentialA-Funktion (wincred.h)

Artikel
03/03/2024

Die CredUnmarshalCredential-Funktion transformiert gemarsierte Anmeldeinformationen wieder in ihre ursprüngliche Form.

Syntax

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

Parameter

[in] MarshaledCredential

Zeiger auf eine NULL-Zeichenfolge, die die gemarselten Anmeldeinformationen enthält.

[out] CredType

Typ der von MarshaledCredential angegebenen Anmeldeinformationen.

Dies ist einer der CRED_MARSHAL_TYPE Werte.

[out] Credential

Zeiger auf die nichtmarshalierten Anmeldeinformationen. Wenn CredTypeCertCredential zurückgibt, ist der zurückgegebene Zeiger auf eine CERT_CREDENTIAL_INFO Struktur. Wenn CredTypeUsernameTargetCredential zurückgibt, ist der zurückgegebene Zeiger auf eine USERNAME_TARGET_CREDENTIAL_INFO Struktur.

Der Aufrufer sollte den zurückgegebenen Puffer mithilfe von CredFree freigeben.

Rückgabewert

Diese Funktion gibt TRUE bei erfolg und FALSE bei Fehler zurück. Die GetLastError-Funktion kann aufgerufen werden, um einen spezifischeren status Code abzurufen. Der folgende status Code kann zurückgegeben werden:

ERROR_INVALID_PARAMETER

MarshaledCredential ist ungültig.

Hinweise

Hinweis

Der wincred.h-Header definiert CredUnmarshalCredential 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