IOCSPAdmin：：GetConfiguration 方法 (certadm.h)

GetConfiguration 方法會連線到在線憑證狀態通訊協定 (OCSP) 回應程式伺服器，並使用伺服器的組態資訊初始化 OCSPAdmin 物件。

語法

HRESULT GetConfiguration(
  [in] const BSTR   bstrServerName,
  [in] VARIANT_BOOL bForce
);

參數

[in] bstrServerName

包含 responder-server 名稱的字串。

[in] bForce

C++	如果 呼叫端想要在找不到 OCSP 回應程式服務執行中的實例時，從伺服器的登錄讀取回應程式組態，VARIANT_TRUE;否則， VARIANT_FALSE。
VB	如果 呼叫端想要在找不到 OCSP 回應程式服務執行中的實例時，從伺服器的登錄讀取回應程式組態，則為 True;否則為 False。

傳回值

VB

如果方法成功，則會傳回 S_OK。

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

如果方法傳回 HRESULT_FROM_WIN32 (ERROR_INVALID_STATE) ，則組態已經初始化。

如果方法傳回E_INVALIDARG，pVal 參數已設定為NULL。

備註

下表列出方法呼叫上 bForce 參數值的效果。

目標伺服器上的 OCSP 回應程式服務	bForceVARIANT_TRUE	bForceVARIANT_FALSE
執行中	從服務擷取組態。	從服務擷取組態。
已停止	嘗試從伺服器登錄擷取組態。 如果此嘗試失敗，請傳回錯誤。	傳回錯誤。

 

下表列出方法呼叫上 bForce 參數值的效果。

目標伺服器上的 OCSP 回應程式服務	bForce 為 True	bForce 為 False
執行中	從服務擷取組態。	從服務擷取組態。
已停止	嘗試從伺服器登錄擷取組態。 如果此嘗試失敗，請傳回錯誤。	傳回錯誤。

 

這個方法會嘗試從 OCSP 回應程式服務的執行中實例讀取組態，但如果服務未執行或處於無法存取的狀態，可能無法執行。 如果找不到執行中的實例，呼叫端可以指示 方法從伺服器的登錄讀取組態。

如果您嘗試針對指定的 OCSPAdmin 物件多次呼叫此方法，方法就會失敗。 OCSPAdmin 的每個實例都會對應至一個回應程式伺服器。 若要連接到 OCSP 回應程式伺服器數位中的另一部伺服器，請建立 OCSPAdmin 物件的新實例。

規格需求

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

另請參閱

IOCSPAdmin