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