IOCSPAdmin::SetConfiguration method

The SetConfiguration method updates a responder service with configuration changes.

Syntax


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

Parameters

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.

VBTrue 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.

Return value

VB

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.

Remarks

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

OCSP responder service on the target serverbForce is VARIANT_TRUEbForce 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 serverbForce is TruebForce 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.

 

Requirements

Minimum supported client

None supported

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

See also

IOCSPAdmin

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.