Share via

IX509ExtensionAlternativeNames：：InitializeEncode 方法 (certenroll.h)

  • 發行項

InitializeEncode 方法會從 IAlternativeNames 集合初始化延伸模組。

語法

HRESULT InitializeEncode(
  [in] IAlternativeNames *pValue
);

參數

[in] pValue

IAlternativeNames 介面的指標。

傳回值

如果函式成功，函式會傳回 S_OK。

如果函式失敗，它會傳回 HRESULT 值，指出錯誤。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

傳回碼/值 Description
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)
對象已經初始化。

備註

方法會將名稱集合與 XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17) 對象標識碼 (OID) 產生關聯，並使用 可辨別編碼規則 (DER) 進行編碼。

您必須先呼叫 InitializeEncode 或 InitializeDecode ，才能使用 IX509ExtensionAlternativeNames 物件。 這兩種方法彼此互補。 InitializeEncode 方法可讓您從原始數據建構 DER 編碼的抽象語法表示法一 (ASN.1) 擴充物件，而 InitializeDecode 方法可讓您從編碼物件初始化原始數據。

您可以擷取此延伸模組的下列屬性：

  • Critical 屬性可識別延伸模組是否為重要。 您也可以指定這個屬性。
  • ObjectId 屬性會擷取 OID。
  • AlternativeNames 屬性會擷取原始延伸模組數據 () 的名稱集合。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 certenroll.h
Dll CertEnroll.dll

另請參閱

IX509ExtensionAlternativeNames