ICertAdmin2::SetConfigEntry 方法 (certadm.h)
SetConfigEntry方法會設定憑證授權單位單位 (CA) 的組態資訊。
語法
HRESULT SetConfigEntry(
[in] const BSTR strConfig,
[in] const BSTR strNodePath,
[in] const BSTR strEntryName,
[in] VARIANT *pvarEntry
);
參數
[in] strConfig
字串值,代表 CA 的有效組態字串,格式為 COMPUTERNAME\CANAME,其中 COMPUTERNAME 是憑證服務伺服器的網路名稱,而 CANAME 是 CA 的一般名稱,如憑證服務設定期間輸入。 如需組態字串名稱的相關資訊,請參閱 ICertConfig。 此參數可以是空字串,在此情況下,函式會設定 CA 專屬的組態資訊。 此參數不可為 Null。
重要SetConfigEntry 不會在設定字串變更時清除內部快取。 當您變更 CA 的組態字串時,您必須具現化新的 ICertAdmin 物件,並使用新的組態字串再次呼叫此方法。
[in] strNodePath
字串值,表示組態資訊的節點路徑。 此參數可以是空字串,在此情況下,函式會從 strConfig所識別的路徑擷取組態資訊。 此參數不可為 Null。
[in] strEntryName
字串值,表示正在設定其資訊的專案名稱。 此值可以是空字串,在此情況下,預設專案是所設定的專案。 此參數不可為 Null。
[in] pvarEntry
C++ | 指定要設定之資訊的 VARIANT 指標。 如果此值是空的,則會刪除指定的索引鍵。 |
VB | 指定要 設定之資訊的 Variant。 如果此值是空的,則會刪除指定的索引鍵。 |
傳回值
VB
如果函式成功,傳回值會S_OK。如果函式失敗,傳回值就是 指出錯誤的 HRESULT 。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
備註
組態資訊會儲存在登錄的下列路徑下。
\ HKEY_LOCAL_MACHINE系統\CurrentControlSet\服務\CertSvc\配置\[儲存名稱]\[strNodePath]\[strEntryName]
其中 ,CALNITIZEDNAME 是 CA 的 清理名稱 。 如需清理名稱的詳細資訊,請參閱 ICertConfig2::GetConfig。規格需求
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | certadm.h (包含 Certsrv.h) |
程式庫 | Certidl.lib |
Dll | Certadm.dll |