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 資料行。 類型可以是下列其中一種類型。
值 | 意義 |
---|---|
|
帶正負號的長數據 |
|
保留供日後使用) 的日期/時間 ( |
|
二進位資料 |
|
Unicode 字串數據 |
[in] Flags
下列旗標可用來指定傳回屬性值的格式;這些旗標只對二進位數據 (的意義,例如憑證、憑證鏈結或 證書吊銷清單) ,否則會予以忽略。
[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