IX509ExtensionSubjectKeyIdentifier::InitializeEncode 方法 (certenroll.h)
InitializeEncode 方法會從包含索引鍵標識碼的位元組數位初始化延伸模組。 位元組陣列是以 Unicode 編碼的字串表示。
語法
HRESULT InitializeEncode(
[in] EncodingType Encoding,
[in] BSTR strKeyIdentifier
);
參數
[in] Encoding
EncodingType 列舉值,指定套用至 strKeyIdentifier 參數的 Unicode 編碼類型。
[in] strKeyIdentifier
包含金鑰標識碼的 BSTR 變數。
傳回值
如果函式成功,函式會傳回 S_OK。
如果函式失敗,它會傳回 HRESULT 值,指出錯誤。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
傳回碼/值 | Description |
---|---|
|
對象已經初始化。 |
備註
一般而言,輸入值應該是證書頒發機構單位簽署憑證中所含 公鑰 的 SHA-1 哈希。 方法會將值與 XCN_OID_SUBJECT_KEY_IDENTIFIER (2.5.29.14) 對象標識碼 (OID) 產生關聯,並使用 可辨別編碼規則 (DER) 進行編碼。
您必須先呼叫 InitializeEncode 或 InitializeDecode ,才能使用 IX509ExtensionSubjectKeyIdentifier 物件。 這兩種方法彼此互補。 InitializeEncode 方法可讓您從原始數據建構 DER 編碼的抽象語法表示法一 (ASN.1) 擴充物件,而 InitializeDecode 方法可讓您從編碼物件初始化原始數據。
您可以擷取此延伸模組的下列屬性:
- Critical 屬性可識別延伸模組是否為重要。 您也可以指定這個屬性。
- ObjectId 屬性會擷取 OID。
- AuthorityKeyIdentifier 屬性會擷取原始數據。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | certenroll.h |
Dll | CertEnroll.dll |