Configuration d’un composant à regrouper
Vous pouvez configurer un composant pour qu’il soit mis en pool uniquement lorsqu’il est correctement écrit pour prendre en charge le pool. Pour plus d’informations sur ces exigences, consultez Configuration requise pour les objets pouvant être mis en pool.
Notes
Par défaut, un composant n’est pas configuré pour être mis en pool.
Lorsque vous configurez un composant à mettre en pool, vous pouvez spécifier les propriétés suivantes pour déterminer comment COM+ gère le pool :
- Taille minimale du pool. Représente le nombre d’objets qui sont créés au démarrage de l’application et le nombre minimal d’objets qui sont conservés dans le pool pendant l’exécution de l’application. Si le nombre d’objets disponibles dans le pool est inférieur au minimum spécifié, de nouveaux objets sont créés pour répondre aux demandes d’objets en attente et remplir le pool. Si le nombre d’objets disponibles dans le pool est supérieur au nombre minimal, ces objets excédentaires sont détruits au cours d’un cycle propre-up.
- Taille maximale du pool. Représente le nombre maximal d’objets mis en pool que le gestionnaire de regroupement va créer, à la fois activement utilisés par les clients et inactifs dans le pool. Lors de la création d’objets, le gestionnaire de regroupement vérifie que la taille maximale du pool n’a pas été atteinte et, si ce n’est pas le cas, le gestionnaire de pool crée une nouvelle instance de l’objet à distribuer au client. Si la taille maximale du pool a été atteinte, les demandes clientes sont mises en file d’attente et reçoivent le premier objet disponible du pool sur la base du premier arrivé, premier servi. Les demandes de création d’objets expirent après une période spécifiée.
- Délai d’expiration de création (ms). Spécifie la durée pendant laquelle un client attendra, en millisecondes, qu’un objet soit retourné à partir du pool après un appel à CoCreateInstance. Si l’appel du client échoue, l’erreur E_TIMEOUT est retournée.
Pour définir des propriétés liées au regroupement
Dans le volet d’informations de l’outil d’administration Services de composants, cliquez avec le bouton droit sur le composant que vous souhaitez configurer, puis cliquez sur Propriétés.
Dans la boîte de dialogue Propriétés du composant, cliquez sur l’onglet Activation .
Pour activer le regroupement d’objets pour le composant, sélectionnez la zone Activer le regroupement d’objets case activée.
Dans la zone Taille minimale du pool , entrez le nombre minimal d’objets de ce type dans le pool. Le pool sera conservé pour avoir au moins ce nombre d’objets.
Dans la zone u, entrez le nombre maximal d’objets de ce type dans le pool. Le nombre d’objets activés et désactivés ne dépassera jamais cette valeur.
Dans la zone Délai d’expiration de création (ms), entrez la durée, en millisecondes, qu’un client attend un objet mis en pool si un objet n’est pas immédiatement disponible.
Rubriques connexes