CryptInstallDefaultContext 函数 (wincrypt.h)

重要 此 API 已弃用。 新的和现有的软件应开始使用 加密下一代 API。 Microsoft 可能会在将来的版本中删除此 API。
 
CryptInstallDefaultContext 函数安装特定提供程序,作为指定算法的默认上下文提供程序。

语法

BOOL CryptInstallDefaultContext(
  [in]  HCRYPTPROV           hCryptProv,
  [in]  DWORD                dwDefaultType,
  [in]  const void           *pvDefaultPara,
  [in]  DWORD                dwFlags,
  [in]  void                 *pvReserved,
  [out] HCRYPTDEFAULTCONTEXT *phDefaultContext
);

参数

[in] hCryptProv

要用作默认上下文的加密服务提供程序的句柄。 此句柄是使用 CryptAcquireContext 函数获取的。

[in] dwDefaultType

指定要安装的上下文的类型。 这必须是以下值之一。

含义
CRYPT_DEFAULT_CONTEXT_CERT_SIGN_OID
安装用于验证单个证书签名类型的默认提供程序。

pvDefaultPara 参数是以 null 结尾的 ANSI 字符串的地址,该字符串包含用于安装提供程序的证书签名算法的对象标识符,例如,szOID_OIWSEC_md5RSA。 如果 pvDefaultPara 参数为 NULL,则指定的提供程序用于验证所有证书签名。 设置CRYPT_DEFAULT_CONTEXT_PROCESS_FLAG标志时,pvDefaultPara 参数不能为 NULL

CRYPT_DEFAULT_CONTEXT_MULTI_CERT_SIGN_OID
安装用于验证多个证书签名类型的默认提供程序。

pvDefaultPara 参数是CRYPT_DEFAULT_CONTEXT_MULTI_OID_PARA结构的地址,该结构包含一组对象标识符,用于标识要为其安装指定提供程序的证书签名算法。

[in] pvDefaultPara

指定要为其安装默认上下文提供程序的对象。 此参数的格式取决于 dwDefaultType 参数的内容。

[in] dwFlags

一组标志,用于修改此函数的行为。 这可以是零,也可以是以下一个或多个值的组合。

含义
CRYPT_DEFAULT_CONTEXT_AUTO_RELEASE_FLAG
进程或线程结束时,将自动释放由 hCryptProv 参数指定的提供程序句柄。 如果未指定此标志,则调用方有责任在不再需要该句柄时使用 CryptReleaseContext 函数释放提供程序句柄。 如果在进程或线程退出之前调用 CryptUninstallDefaultContext 函数,则不会释放提供程序句柄。
CRYPT_DEFAULT_CONTEXT_PROCESS_FLAG
提供程序适用于进程中的所有线程。 如果未指定此标志,则提供程序仅适用于调用线程。 设置此标志时 ,pvDefaultPara 参数不能为 NULL

[in] pvReserved

此参数留待将来使用。

[out] phDefaultContext

接收默认上下文句柄的 HCRYPTDEFAULTCONTEXT 变量的地址。 此句柄将传递给 CryptUninstallDefaultContext 函数,以卸载默认上下文提供程序。

返回值

如果函数成功,则返回值为非零 (TRUE) 。 如果函数失败,则返回值为零, (FALSE) 。 有关扩展的错误信息,请调用 GetLastError

注解

已安装的默认上下文提供程序按堆栈顺序排列,因此在搜索默认上下文提供程序时,系统会从最近安装的提供程序开始。 在提供程序的每个进程列表之前搜索提供程序的每线程列表。 找到匹配项后,系统不会继续搜索其他匹配项。

在调用 CryptUninstallDefaultContext 或线程或 进程 退出之前,已安装的提供程序句柄必须保持可用。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 wincrypt.h
Library Crypt32.lib
DLL Crypt32.dll

另请参阅

CryptUninstallDefaultContext