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
Fonctionnement du regroupement d’objets
Configuration requise pour les objets pouvant être mis en pool