ICertAdmin2：：GetConfigEntry 方法 (certadm.h)

  • 發行項

GetConfigEntry 方法會擷取證書頒發機構單位 (CA) 的組態資訊。

語法

HRESULT GetConfigEntry(
  [in]  const BSTR strConfig,
  [in]  const BSTR strNodePath,
  [in]  const BSTR strEntryName,
  [out] VARIANT    *pvarEntry
);

參數

[in] strConfig

字串值，代表 CA 的有效組態字串，格式為 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是憑證服務伺服器的網路名稱，而 CANAME 是 CA 的一般名稱，如憑證服務設定期間輸入。 如需組態字串名稱的相關信息，請參閱 ICertConfig。 此參數可以是空字串，在此情況下，函式會擷取不是 CA 特有的組態資訊。 此參數不可為 NULL。

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

[in] strNodePath

字串值，表示組態信息的節點路徑。 此參數可以是空字串，在此情況下，函式會從 strConfig 所識別的路徑擷取組態資訊。 此參數不可為 NULL。

[in] strEntryName

字串值，表示正在擷取其資訊的項目名稱。 此值可以是空字串，在此情況下會擷取所有項目名稱。 此參數不可為 NULL。

[out] pvarEntry

VARIANT 的指標，可接收要求的資訊。

傳回值

C++

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

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

VB

傳回值是 Variant ，代表所擷取的組態資訊。

備註

組態資訊會儲存在登錄的下列路徑下。

\ HKEY_LOCAL_MACHINE系統\CurrentControlSet\服務\CertSvc\配置\[儲存名稱]\[strNodePath]\[strEntryName]

其中 ，CALNITIZEDNAME 是 CA 的 清理名稱 。 如需清理名稱的詳細資訊，請參閱 ICertConfig2：：GetConfig。

規格需求

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

另請參閱

ICertAdmin2