IObjectControl::CanBePooled method (comsvcs.h)

Notifies the COM+ run-time environment whether the object can be pooled for reuse when it is deactivated.

Syntax

BOOL CanBePooled();

Return value

If the object can be pooled for reuse, the return value is TRUE. Otherwise, it is FALSE.

Remarks

When an object returns TRUE from the CanBePooled method, it indicates to the COM+ run-time environment that it can be added to an object pool after deactivation rather than being destroyed. Whenever an instance is required, one is drawn from the pool rather than created.

Returning TRUE from the CanBePooled method does not guarantee that objects will be recycled; it only gives the COM+ run-time environment permission to recycle them. Returning FALSE from the CanBePooled method guarantees that instances of a component are not recycled.

The Activate method is called if a new instance is created or if a recycled instance is drawn from the pool. Similarly, the Deactivate method is called every time the object is deactivated, whether it is being destroyed or returned to the pool for recycling.

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

See also

COM+ Object Pooling

How Object Pooling Works

IObjectControl

Requirements for Poolable Objects