RecycleSurrogate function (comsvcs.h)
Recycles the calling process.
For similar functionality, see IMTxAS::RecycleSurrogate.
Syntax
HRESULT RecycleSurrogate(
[in] long lReasonCode
);
Parameters
[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.
|
Return value
This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.
Requirements
| 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 |
See also
ICOMAdminCatalog2::RecycleApplicationInstances