IX509AttributeRenewalCertificate：：InitializeEncode 方法 (certenroll.h)

InitializeEncode方法會使用要更新的憑證，初始化 屬性。 憑證必須使用 der) 可辨別編碼規則 (編碼。

語法

HRESULT InitializeEncode(
  [in] EncodingType Encoding,
  [in] BSTR         strCert
);

參數

[in] Encoding

EncodingType列舉值，指定套用至strCert參數中包含的憑證的 Unicode 編碼類型。

[in] strCert

包含 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。

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

規格需求

另請參閱

IX509AttributeRenewalCertificate