CredUnmarshalCredentialA 函数 (wincred.h)

CredUnmarshalCredential 函数将封送凭据转换回其原始形式。

语法

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

参数

[in] MarshaledCredential

指向包含封送凭据的以 null 结尾的字符串的指针。

[out] CredType

MarshaledCredential指定的凭据类型。

这是 CRED_MARSHAL_TYPE 值之一。

[out] Credential

指向未分配凭据的指针。 如果 CredType 返回 CertCredential,则返回的指针指向 CERT_CREDENTIAL_INFO 结构。 如果 CredType 返回 UsernameTargetCredential,则返回的指针指向 USERNAME_TARGET_CREDENTIAL_INFO 结构。

调用方应使用 CredFree释放返回的缓冲区。

返回值

此函数返回成功 TRUE,并在失败时 FALSE。 可以调用 GetLastError 函数以获取更具体的状态代码。 可以返回以下状态代码:

ERROR_INVALID_PARAMETER

MarshaledCredential 无效。

言论

注意

wincred.h 标头将 CredUnmarshalCredential 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 wincred.h
Advapi32.lib
DLL Advapi32.dll

另请参阅

CERT_CREDENTIAL_INFO

CRED_MARSHAL_TYPE

CredFree

CredMarshalCredential

GetLastError

USERNAME_TARGET_CREDENTIAL_INFO