共用方式為

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

字串值，代表格式為 COMPUTERNAME\CANAME 之 CA 的有效組態字串，其中 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 支援的範本清單。

資料格式：String。

[in] PropIndex

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

[in] PropType

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

價值 意義
PROPTYPE_LONG
 已簽署 長 數據。
PROPTYPE_DATE
 日期/時間（保留供日後使用）。
PROPTYPE_BINARY
 二進位數據。
PROPTYPE_STRING
 Unicode字串 數據。

[in] pvarPropertyValue

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

傳回值

VB

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

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

要求

要求 價值
最低支援的用戶端 不支援
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 certadm.h （include Certsrv.h）
連結庫 Certidl.lib
DLL Certadm.dll

另請參閱

ICertAdmin2

ICertAdmin2：：GetCAProperty