iObjectId::InitializeFromName 方法 (certenroll.h)

InitializeFromName 方法从CERTENROLL_OBJECTID枚举值初始化 对象。 此方法已启用 Web。

语法

HRESULT InitializeFromName(
  [in] CERTENROLL_OBJECTID Name
);

参数

[in] Name

CERTENROLL_OBJECTID枚举值。

返回值

如果函数成功,该函数将返回 S_OK

如果函数失败,它将返回指示错误的 HRESULT 值。 可能的值包括(但并不限于)下表中的项。 有关常见错误代码的列表,请参阅 常见 HRESULT 值

返回代码/值 说明
CERTSRV_E_PROPERTY_EMPTY
找不到 OID 信息。
CRYPT_E_UNKNOWN_ALGO
无法识别算法名称。
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)
对象已初始化。

注解

每个 CERTENROLL_OBJECTID 值都与 ASN.1 对象标识符相关联。 例如, XCN_OID_ECDSA_SHA1 值与包含 1.2.840.10045.4.1 的字符串相关联。 这是 iso (1) 成员主体 (2) 我们 (840) 10045 签名 (4) sha1 (1) 对象标识符的点十进制表示形式。

InitializeFromName 方法在注册表中搜索与 ASN.1 对象标识符关联的信息。 如果找到信息,该方法将在内部填充 CRYPT_OID_INFO 结构并将其与 对象相关联。 如果可能,该方法还使用本地信息来初始化 对象的显示名称。

可以调用以下属性来检索有关初始化的 IObjectId 对象的信息:

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 certenroll.h
DLL CertEnroll.dll

另请参阅

FriendlyName

IObjectID