ObjectControl::CanBePooled-Methode (comsvcs.h)
Gibt an, ob das Objekt zur Wiederverwendung in einem Pool zusammengefasst werden kann, wenn es deaktiviert ist.
Syntax
HRESULT CanBePooled(
[out] VARIANT_BOOL *pbPoolable
);
Parameter
[out] pbPoolable
Gibt an, ob die COM+-Laufzeitumgebung dieses Objekt bei der Deaktivierung für eine spätere Wiederverwendung poolen kann.
Rückgabewert
Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL und S_OK zurückgeben.
Hinweise
Wenn ein Objekt TRUE von CanBePooled zurückgibt, gibt es für die COM+-Laufzeitumgebung an, dass es nach der Deaktivierung einem Objektpool hinzugefügt werden kann, anstatt zerstört zu werden. Wenn ein instance erforderlich ist, wird eine aus dem Pool gezogen, anstatt erstellt zu werden.
Die Rückgabe von TRUE von CanBePooled garantiert nicht, dass Objekte recycelt werden. Sie erteilt der COM+-Laufzeitumgebung nur die Berechtigung, sie zu recyceln. Durch zurückgeben von FALSE von der CanBePooled-Methode wird sichergestellt, dass Instanzen einer Komponente nicht wiederverwendet werden.
Die Activate-Methode wird aufgerufen, wenn eine neue instance erstellt wird oder ein recyceltes instance aus dem Pool gezogen wird. Ebenso wird die Deactivate-Methode jedes Mal aufgerufen, wenn das Objekt deaktiviert wird, unabhängig davon, ob es zerstört oder zum Recycling an den Pool zurückgegeben wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | comsvcs.h |