CredUnmarshalCredentialA 函数 (wincred.h)

项目
03/03/2024

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 [仅限桌面应用]
目标平台	Windows
标头	wincred.h
Library	Advapi32.lib
DLL	Advapi32.dll