ICertRequest2：：GetCAProperty 方法 (certcli.h)

  • 發行項

GetCAProperty 方法會擷取證書頒發機構單位的屬性值， (CA) 。 這個方法的功能與 ICertAdmin2：：GetCAProperty 相同。 如需這個方法的相關信息，請參閱 ICertAdmin2：：GetCAProperty。

語法

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

參數

[in] strConfig

代表 CA 的有效組態字串，格式為 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是憑證服務伺服器的網路名稱，而 CANAME 是 CA 的一般名稱，如憑證服務設定期間所輸入。 如需設定字串名稱的相關信息，請參閱 ICertConfig。

[in] PropId

指定屬性識別碼。 如需此參數的相關信息，請參閱 ICertAdmin2：：GetCAProperty 中的數據表。

[in] PropIndex

如果 PropId 已編製索引，則擷取屬性值時要使用的以零起始的索引。 如果未編制 PropId 的索引，則會忽略此值。

[in] PropType

指定屬性的類型，其對應於 PropId 資料表中的 Type 資料行。 類型可以是下列其中一種類型。

值 意義
PROPTYPE_LONG
 帶正負號的長數據
PROPTYPE_DATE
 保留供日後使用) 的日期/時間 (
PROPTYPE_BINARY
 二進位資料
PROPTYPE_STRING
 Unicode 字串數據

[in] Flags

下列旗標可用來指定傳回屬性值的格式;這些旗標只對二進位數據 (的意義，例如憑證、憑證鏈結或 證書吊銷清單) ，否則會予以忽略。

值 意義
CV_OUT_BASE64
 沒有 BEGIN/END 的 BASE64
CV_OUT_BASE64HEADER
 具有 BEGIN CERTIFICATE 和 END CERTIFICATE 的 BASE64
CV_OUT_BASE64REQUESTHEADER
 具有 BEGIN NEW CERTIFICATE REQUEST 和 END NEW CERTIFICATE REQUEST 的 BASE64
CV_OUT_BASE64X509CRLHEADER
 BASE64 含 BEGIN X509 CRL 和 END X509 CRL
CV_OUT_BINARY
 二進位
CV_OUT_HEX
 十六進位字串
CV_OUT_HEXADDR
 具有位址/位移的十六進位字串
CV_OUT_HEXASCII
 使用 ASCII 的十六進位字串
CV_OUT_HEXASCIIADDR
 具有 ASCII 和位址/位移的十六進位字串

[out, retval] pvarPropertyValue

接收所要求屬性值之 VARIANT 的指標。

當您完成使用 VARIANT 時，請呼叫 VariantClear 函式來釋放它。

傳回值

C++

如果方法成功，方法會傳回S_OK。

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

VB

傳回值是 一個 Variant ，可接收要求的屬性值。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 certcli.h (包含 Certsrv.h)
程式庫 Certidl.lib
Dll Certcli.dll

另請參閱

CCertRequest

ICertRequest

ICertRequest2