IX509ExtensionAlternativeNames::InitializeDecode 方法 (certenroll.h)
InitializeDecode 方法會從包含擴充值的 可辨別編碼規則 (DER) 編碼位元組數位初始化延伸模組。 編碼的位元組陣列是由 Unicode 編碼字串表示。
語法
HRESULT InitializeDecode(
[in] EncodingType Encoding,
[in] BSTR strEncodedData
);
參數
[in] Encoding
EncodingType 列舉值,指定套用至 strEncodedData 值的 Unicode 編碼類型。
[in] strEncodedData
包含 DER 編碼延伸模組的 BSTR 變數。
傳回值
如果函式成功,函式會傳回 S_OK。
如果函式失敗,它會傳回 指出錯誤的 HRESULT 值。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
傳回碼/值 | Description |
---|---|
|
對象已經初始化。 |
備註
如果您有 DER 編碼 的抽象語法表示法 1 (ASN.1) 物件包含 AlternativeNames 擴充功能,您可以使用此方法。 您必須在 Unicode 編碼字串中提供 DER 編碼的物件。 如需詳細資訊,請參閱 IBinaryConverter 介面。
您必須先呼叫 InitializeEncode 或 InitializeDecode ,才能使用 IX509ExtensionAlternativeNames 物件。 這兩種方法彼此互補。 InitializeEncode 方法可讓您從原始數據建構 DER 編碼的 ASN.1 擴充物件,而 InitializeDecode 方法可讓您從編碼的物件初始化原始數據。
您可以擷取此延伸模組的下列屬性:
- Critical 屬性會識別延伸模組是否為關鍵。 您也可以指定這個屬性。
- ObjectId 屬性會擷取 OID) (物件識別碼。
- AlternativeNames 屬性會擷取原始延伸模組數據 (名稱集合) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | certenroll.h |
Dll | CertEnroll.dll |