Share via

3.1.4.21.7 RecycleContainer (Opnum 9)

  • Article

This method is called by a client to recycle an instance container.

 HRESULT RecycleContainer(
   [in] GUID* ContainerIdentifier,
   [in] long lReasonCode
 );

ContainerIdentifier: The container identifier of an instance container.

lReasonCode: A value representing an application-specific informational reason code for why the instance container is being recycled.

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.

Upon receiving a call to this method, the server MUST verify that there exists an instance container with the container identifier specified in ContainerIdentifier, and fail the call if not.

The server then MUST attempt to recycle the instance container, and fail the call if it cannot.

The server SHOULD produce an implementation-specific<351> log record of the instance container being recycled, including lReasonCode in the log record.