CredUnmarshalCredentialW-Funktion (wincred.h)
Die CredUnmarshalCredential-Funktion transformiert gemarsierte Anmeldeinformationen wieder in ihre ursprüngliche Form.
Syntax
BOOL CredUnmarshalCredentialW(
[in] LPCWSTR 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
| 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 |