IObjectId::InitializeFromName 方法(certenroll.h)

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

Syntax

HRESULT InitializeFromName(
  [in] CERTENROLL_OBJECTID Name
);

参数

[in] Name

CERTENROLL_OBJECTID枚举值。

返回值

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

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

返回代码/值 Description
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)member-body(2)us(840)10045 signatures(4)sha1(1) 对象标识符的点小数表示形式。

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

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

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows操作系统
Header certenroll.h
DLL CertEnroll.dll

另请参阅

FriendlyName

IObjectID