IObjectId：：InitializeFromName 方法 (certenroll.h)

  • 發行項

InitializeFromName 方法會從CERTENROLL_OBJECTID列舉值初始化 物件。 此方法已啟用 Web。

語法

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) 成員主體 (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