This topic has not yet been rated - Rate this topic

IOCSPAdmin::SetConfiguration method

The SetConfiguration method updates a responder service with configuration changes.


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

bstrServerName [in]

A string that contains the responder-service name.

bForce [in]

C++	VARIANT_TRUE if the method should update the responder service registry when the service is offline or unavailable; otherwise, VARIANT_FALSE. If the service is offline or unavailable and the bForce parameter is VARIANT_TRUE, SetConfiguration updates the responder service registry directly.
VB	True if the method should update the responder service registry when the service is offline or unavailable; otherwise, False. If the service is offline or unavailable and the bForce parameter is True, SetConfiguration updates the responder service registry directly.

If the method succeeds, it returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

The following table lists the effects of the bForce parameter value on the method call.

OCSP responder service on the target server	bForce is VARIANT_TRUE	bForce is VARIANT_FALSE
Running	Retrieve configuration from the service.	Retrieve configuration from the service.
Stopped	Attempt to retrieve configuration from the server registry. If this attempt fails, return an error.	Return an error.

The following table lists the effects of the bForce parameter value on the method call.

OCSP responder service on the target server	bForce is True	bForce is False
Running	Retrieve configuration from the service.	Retrieve configuration from the service.
Stopped	Attempt to retrieve configuration from the server registry. If this attempt fails, return an error.	Return an error.

Minimum supported client	None supported [desktop apps only]
Minimum supported server	Windows Server 2008 Datacenter, Windows Server 2008 Enterprise [desktop apps only]
Header	Certadm.h (include Certsrv.h)
IDL	Certadm.idl
Library	Certadm.lib
DLL	Certadm.dll
IID	IID_IOCSPAdmin is defined as 322E830D-67DB-4FE9-9577-4596D9F09294

Community Additions