通过

CredProtectA 函数 （wincred.h）

  • 项目

CredProtect 函数对指定的凭据进行加密，以便只有当前安全上下文才能解密它们。

语法

BOOL CredProtectA(
  [in]      BOOL                 fAsSelf,
  [in]      LPSTR                pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPSTR                pszProtectedCredentials,
  [in, out] DWORD                *pcchMaxChars,
  [out]     CRED_PROTECTION_TYPE *ProtectionType
);

参数

[in] fAsSelf

设置为 TRUE 指定凭据在当前进程的安全上下文中加密。 设置为 FALSE，以指定凭据在调用线程安全上下文的安全上下文中加密。

[in] pszCredentials

指向指定要加密的凭据的字符串的指针。 该函数将加密 cchCredentials 参数中提供的字符数。

[in] cchCredentials

pszCredentials 缓冲区的大小（以字符为单位）。

[out] pszProtectedCredentials

指向输出中接收加密凭据的字符串的指针。

[in, out] pcchMaxChars

pszProtectedCredentials 缓冲区的大小（以字符为单位）。 在输出中，如果 pszProtectedCredentials 的大小不足以接收加密凭据，则此参数指定 pszProtectedCredentials 缓冲区所需的大小（以字符为单位）。

[out] ProtectionType

指向 CRED_PROTECTION_TYPE 枚举类型的指针，该类型在输出中指定提供的保护类型。

返回值

如果函数成功，则 TRUE;否则，FALSE。

有关扩展的错误信息，请调用 GetLastError 函数。

言论

请注意，CredProtect 函数的输出不受完整性保护，因此如果修改了输出，则不会更新 CredUnprotect 函数，并且可能会生成不正确的结果。

注意

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

要求

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