ObjectControl::CanBePooled, méthode (comsvcs.h)

Indique si l’objet peut être mis en pool pour être réutilisé lorsqu’il est désactivé.

Syntaxe

HRESULT CanBePooled(
  [out] VARIANT_BOOL *pbPoolable
);

Paramètres

[out] pbPoolable

Indique si l’environnement d’exécution COM+ peut mettre en pool cet objet lors de la désactivation en vue d’une réutilisation ultérieure.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL et S_OK.

Remarques

Lorsqu’un objet retourne TRUE à partir de CanBePooled, il indique à l’environnement d’exécution COM+ qu’il peut être ajouté à un pool d’objets après la désactivation au lieu d’être détruit. Chaque fois qu’une instance est requise, elle est extraite du pool au lieu d’être créée.

Le retour de TRUE à partir de CanBePooled ne garantit pas que les objets seront recyclés; il donne uniquement à l’environnement d’exécution COM+ l’autorisation de les recycler. Le retour de FALSE à partir de la méthode CanBePooled garantit que les instances d’un composant ne sont pas recyclées.

La méthode Activate est appelée si une nouvelle instance est créée ou si une instance recyclée est extraite du pool. De même, la méthode Deactivate est appelée chaque fois que l’objet est désactivé, qu’il soit détruit ou retourné au pool pour recyclage.

Configuration requise

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	comsvcs.h

Voir aussi

Regroupement d’objets COM+

Fonctionnement du regroupement d’objets

ObjectControl

Configuration requise pour les objets pouvant être mis en pool