RecycleSurrogate function

Recycles the calling process.

For similar functionality, see IMTxAS::RecycleSurrogate.

Syntax


HRESULT __cdecl RecycleSurrogate(
  _In_ long lReasonCode
);

Parameters

lReasonCode [in]

The reason code that explains why a process was recycled. The following codes are defined.

ValueMeaning
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]

Header

ComSvcs.h

Library

ComSvcs.lib

DLL

ComSvcs.dll

See also

ICOMAdminCatalog2::RecycleApplicationInstances

 

 

Community Additions

ADD
Show: