ICertAdmin2：：SetCAProperty 方法 (certadm.h)

  • 發行項

SetCAProperty 方法會設定證書頒發機構單位的屬性值， (CA) 。

語法

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

參數

[in] strConfig

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

重要SetCAProperty 不會在設定字串變更時清除內部快取。 當您變更 CA 的組態字串時，您必須具現化新的 ICertAdmin 物件，並使用新的組態字串再次呼叫此方法。

 

[in] PropId

指定下列其中一個屬性識別碼。

如需所有 CA 屬性的相關信息，包括唯讀屬性，請參閱 ICertAdmin2：：GetCAProperty。

值 意義
CR_PROP_KRACERT
 CA 的金鑰復原代理程式 (KRA) 憑證。

數據格式：二進位、已編製索引。
CR_PROP_KRACERTCOUNT
 CA 的 KRA 憑證數目。

數據格式： Long。
CR_PROP_KRACERTUSEDCOUNT
 CA 所使用的 KRA 憑證數目。

數據格式： Long。
CR_PROP_ROLESEPARATIONENABLED
 值，指定是否啟用角色分隔。

數據格式： Long。
CR_PROP_TEMPLATES
 CA 支援的範本清單。

數據格式： 字串。

[in] PropIndex

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

[in] PropType

指定屬性的類型。 此參數可以是下列其中一個值。

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

[in] pvarPropertyValue

C++ 指定屬性值之 VARIANT 的指標。
VB 指定屬性值的 Variant 。

傳回值

VB

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

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

規格需求

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

另請參閱

ICertAdmin2

ICertAdmin2：：GetCAProperty