Share via

3.1.4.16.2 DeleteConfiguration (Opnum 4)

  • Article

This method is called by a client to delete an alternate launch configuration (see section 3.1.1.4) for a conglomeration.

 HRESULT DeleteConfiguration(
   [in] GUID ConglomerationIdentifier
 );

ConglomerationIdentifier: The conglomeration identifier of a conglomeration on the server.

Return Values: This method MUST return S_OK (0x00000000) on success, and a failure result, as specified in [MS-ERREF] section 2.1, on failure. All failure results MUST be treated identically.

Return value/code

Description

0x00000000

S_OK

The call was successful.

Upon receiving a call to this method, the server MUST verify that catalog version negotiation has been performed by checking the negotiated catalog version (see section 3.1.1.5), and fail the call if not.

The server then MUST verify that there exists in the Conglomerations Table a conglomeration identified by ConglomerationIdentifier, that this conglomeration allows updates, and that this conglomeration has an alternate launch configuration, failing the call if not.

The server then MUST attempt to remove the alternate launch configuration for the conglomeration, and fail the call if it cannot.