IMTxAS::RecycleSurrogate method

Recycles the calling process.

In C++, the RecycleSurrogate function should be used instead of this method.

Syntax

HRESULT RecycleSurrogate(
  [in] long lReasonCode
);

Parameters

  • lReasonCode [in]
    The reason code that explains why a process was recycled. The following codes are defined.

    Value Meaning
    CRR_NO_REASON_SUPPLIED 0x00000000

    The reason is not specified.

    CRR_LIFETIME_LIMIT xFFFFFFFF

    The specified number of minutes that an application runs before recycling was reached.

    CRR_ACTIVATION_LIMIT 0xFFFFFFFE

    The specified number of activations was reached.

    CRR_CALL_LIMIT 0xFFFFFFFD

    The specified number of calls to configured objects in the application was reached.

    CRR_MEMORY_LIMIT 0xFFFFFFFC

    The specified memory usage that a process cannot exceed was reached.

    CRR_RECYCLED_FROM_UI xFFFFFFFB

    An administrator decided to recycle the process through the Component Services administration tool.

     

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

See also

ICOMAdminCatalog2::RecycleApplicationInstances

IMTxAS

RecycleSurrogate