CryptRegisterOIDInfo 函数 (wincrypt.h)

项目
08/27/2023

CryptRegisterOIDInfo 函数注册CRYPT_OID_INFO结构中指定的 OID 信息，并将其保存到注册表中。

Crypt32.dll 包含常见 OID 的预定义信息。此函数允许应用程序扩充预定义的 OID 信息。在 CryptRegisterOIDInfo 的第一次调用期间，将安装已注册的 OID 信息。

使用 CryptRegisterOIDInfo 扩展表时，新条目可以放在预定义条目之前或之后，由 dwFlags 控制。注册的 OID 信息的放置会影响 CryptFindOIDInfo 的结果，因为表是按顺序搜索的。首先检查放置在预定义条目之前放置的已注册条目，然后检查预定义条目，最后检查在预定义条目之后放置的已注册条目。返回找到的第一个匹配项。放置在预定义条目之前的新注册条目可以替代其中一个预定义条目。

语法

BOOL CryptRegisterOIDInfo(
  [in] PCCRYPT_OID_INFO pInfo,
  [in] DWORD            dwFlags
);

参数

[in] pInfo

指向 CRYPT_OID_INFO 结构的指针，其中包含要注册的 OID 信息。通过设置结构的 dwGroupId 成员，指定要注册 OID 信息的组。

注意

注册使用加密 API 实现的套件 B 算法的 OID 信息时：下一代 (CNG) ，必须将 CRYPT_OID_INFO 结构的 Algid 成员设置为CALG_OID_INFO_CNG_ONLY (0xFFFFFFFF) 。

[in] dwFlags

默认情况下，注册的 OID 信息是在 Crypt32.dll 的 OID 条目之后安装的。如果设置了CRYPT_INSTALL_OID_INFO_BEFORE_FLAG，则会在 Crypt32.dll 条目之前安装新的 OID 信息。

返回值

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

如果函数失败，则返回值为零 (FALSE) 。

注解

使用完 OID 信息后，通过调用 CryptUnregisterOIDInfo 函数将其注销。

要求

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