共用方式為

IX509AttributeRenewalCertificate：：InitializeDecode 方法 (certenroll.h)

  • 發行項

InitializeDecode 方法會從包含要更新之憑證的 der 可辨別編碼規則 (DER) 編碼位元組陣組初始化 物件。 位元組陣列是以 Unicode 編碼字串表示。

語法

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

參數

[in] Encoding

EncodingType 列舉值，指定套用至輸入字串的 Unicode 編碼類型。

[in] strEncodedData

包含 DER 編碼憑證的 BSTR 變數。

從 Windows 7 和 Windows Server 2008 R2 開始，您可以指定憑證指紋或序號，而不是編碼的憑證。 這樣做會導致函式搜尋適當的本地存儲以尋找相符的憑證。 請記住下列幾點：

  • BSTR 必須是偶數十六進位數位。
  • 忽略十六進位組之間的空格符。
  • Encoding 參數必須設定為 XCN_CRYPT_STRING_HEXRAW。
  • 如果需要私鑰，則只會搜尋個人和要求存放區。
  • 如果不需要私鑰，也會搜尋根和中繼 CA 存放區。

傳回值

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

如果函式失敗，它會傳回 指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

備註

此屬性 的物件標識碼 (OID) XCN_OID_RENEWAL_CERTIFICATE ( 1.3.6.1.4.1.311.13.1) 。 如需詳細資訊，請參閱 CERTENROLL_OBJECTID。

如果您有 DER 編碼 的抽象語法表示法 One (ASN.1) 物件包含屬性值，則可以使用此方法。 您必須在 Unicode 編碼字串中提供 DER 編碼的物件。 如需詳細資訊，請參閱 IBinaryConverter 介面。

您必須先呼叫 InitializeEncode 或 InitializeDecode ，才能使用 IX509AttributeRenewalCertificate 物件。 這兩種方法彼此互補。 InitializeEncode 方法可讓您從原始數據建構編碼的 ASN.1 結構，而 InitializeDecode 方法可讓您從編碼的 ASN.1 結構初始化原始數據。 您可以呼叫 RenewalCertificate 屬性來擷取原始數據。

規格需求

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

另請參閱

IX509AttributeRenewalCertificate