CryptSetProviderA 函数（wincrypt.h）

重要此 API 已弃用。新的和现有的软件应开始使用加密下一代 API。 Microsoft可能会在将来的版本中删除此 API。

CryptSetProvider 函数指定当前用户的默认加密服务提供商（CSP）。

如果设置了当前用户的默认提供程序，则该用户的任何调用都获取该默认提供程序，以 CryptAcquireContext 指定 dwProvType 提供程序类型，而不是 CSP 名称。

此函数的增强版本（CryptSetProviderEx）也可用。

注意典型应用程序不使用此函数。它仅供管理应用程序使用。

语法

BOOL CryptSetProviderA(
  [in] LPCSTR pszProvName,
  [in] DWORD  dwProvType
);

[in] pszProvName

新的默认 CSP 的名称。必须在计算机上安装命名的 CSP。有关可用加密提供程序的列表，请参阅加密提供程序名称。

[in] dwProvType

由 pszProvName指定的 CSP 的提供程序类型。

如果函数成功，则返回值为非零（TRUE）。

如果函数失败，则返回值为零（FALSE）。有关扩展错误信息，请调用 GetLastError。下表列出了一些可能的错误代码。

还可以将错误从内部调用传播到 RegCreateKeyEx，RegSetValueEx。

在调用 cryptAcquireContext 时，典型应用程序不会指定 CSP 名称;但是，应用程序确实可以选择特定的 CSP。这样，用户可以自由选择具有适当安全级别的 CSP。

由于调用 CryptSetProvider 确定从该点运行的所有应用程序的指定类型的 CSP，因此在未经用户同意的情况下，不得调用此函数。

注意

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