Share via

IX509ExtensionBasicConstraints：：InitializeEncode 方法 (certenroll.h)

  • 發行項

InitializeEncode 方法會從布爾值初始化延伸模組，指出憑證主體是否為證書頒發機構單位 (CA) ，以及包含從屬 CA 鏈結深度的整數。

語法

HRESULT InitializeEncode(
  [in] VARIANT_BOOL IsCA,
  [in] LONG         PathLenConstraint
);

參數

[in] IsCA

VARIANT_BOOL變數，指定憑證主體是否為 CA。

[in] PathLenConstraint

LONG 變數，其中包含鏈結中憑證的最大數目。

傳回值

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

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

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

備註

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

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

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

  • Critical 屬性會識別延伸模組是否為關鍵。 您也可以指定這個屬性。
  • ObjectId 屬性會擷取 OID。
  • IsCA 屬性會識別憑證主體是否可以是證書頒發機構單位。
  • PathLenConstraint 屬性會識別次級證書頒發機構單位鏈結的深度。

規格需求

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

另請參閱

IX509ExtensionBasicConstraints