RecycleSurrogate function (comsvcs.h)

Recycles the calling process.

For similar functionality, see IMTxAS::RecycleSurrogate.

Syntax

HRESULT RecycleSurrogate(
  [in] long lReasonCode
);

[in] lReasonCode

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.

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

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	comsvcs.h
Library	ComSvcs.lib
DLL	ComSvcs.dll