3.1.4.1.15 ICertAdminD::ServerControl (Opnum 17)

  • Article

The ServerControl method is used to force the CA server to unregister the ICertAdminD and ICertAdminD2 interfaces.

 HRESULT ServerControl(
   [in, string, unique] wchar_t const* pwszAuthority,
   [in] DWORD dwControlFlags,
   [out, ref] CERTTRANSBLOB* pctbOut
 );

pwszAuthority:  See the pwszAuthority definition in section 3.1.4.1.1.

dwControlFlags: An unsigned integer value that specifies the control to be sent to the certificate server. It MUST take one of the following values.

Value

Meaning

0x000000001

Request unregister for DCOM interfaces for the certificate server.

0x000000002

Not currently used.

0x000000003

Not currently used.

pctbOut: All fields of this parameter MUST be set to 0 on return.

The following processing rules apply.

The CA MUST check the control flags and MUST take the following action:

  1. If the value of the dwControlFlags parameter is 1, the CA MUST unregister the ICertAdminD and ICertAdminD2 interfaces.

  2. If the value of the dwControlFlags parameter is 2 or 3, the CA returns successfully.

  3. If the value of the dwControlFlags parameter is not 1, 2, or 3, the CA MUST return an error. The error code SHOULD be "0x80070057".