CryptInstallDefaultContext 函数 (wincrypt.h)
语法
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
指定要安装的上下文的类型。 这必须是以下值之一。
值 | 含义 |
---|---|
|
安装用于验证单个证书签名类型的默认提供程序。
pvDefaultPara 参数是以 null 结尾的 ANSI 字符串的地址,该字符串包含用于安装提供程序的证书签名算法的对象标识符,例如,szOID_OIWSEC_md5RSA。 如果 pvDefaultPara 参数为 NULL,则指定的提供程序用于验证所有证书签名。 设置CRYPT_DEFAULT_CONTEXT_PROCESS_FLAG标志时,pvDefaultPara 参数不能为 NULL。 |
|
安装用于验证多个证书签名类型的默认提供程序。
pvDefaultPara 参数是CRYPT_DEFAULT_CONTEXT_MULTI_OID_PARA结构的地址,该结构包含一组对象标识符,用于标识要为其安装指定提供程序的证书签名算法。 |
[in] pvDefaultPara
指定要为其安装默认上下文提供程序的对象。 此参数的格式取决于 dwDefaultType 参数的内容。
[in] dwFlags
一组标志,用于修改此函数的行为。 这可以是零,也可以是以下一个或多个值的组合。
值 | 含义 |
---|---|
|
进程或线程结束时,将自动释放由 hCryptProv 参数指定的提供程序句柄。 如果未指定此标志,则调用方有责任在不再需要该句柄时使用 CryptReleaseContext 函数释放提供程序句柄。 如果在进程或线程退出之前调用 CryptUninstallDefaultContext 函数,则不会释放提供程序句柄。 |
|
提供程序适用于进程中的所有线程。 如果未指定此标志,则提供程序仅适用于调用线程。 设置此标志时 ,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 |