Compartilhar via


Método ObjectControl::CanBePooled (comsvcs.h)

Indica se o objeto pode ser agrupado para reutilização quando ele é desativado.

Sintaxe

HRESULT CanBePooled(
  [out] VARIANT_BOOL *pbPoolable
);

Parâmetros

[out] pbPoolable

Indica se o ambiente de tempo de execução COM+ pode agrupar esse objeto na desativação para reutilização posterior.

Valor retornado

Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Comentários

Quando um objeto retorna TRUE de CanBePooled, ele indica ao ambiente de tempo de execução COM+ que ele pode ser adicionado a um pool de objetos após a desativação em vez de ser destruído. Sempre que uma instância é necessária, uma é extraida do pool em vez de ser criada.

Retornar TRUE do CanBePooled não garante que os objetos sejam reciclados; ele só dá ao ambiente de tempo de execução COM+ permissão para reciclá-los. Retornar FALSE do método CanBePooled garante que as instâncias de um componente não sejam recicladas.

O método Activate será chamado se uma nova instância for criada ou se uma instância reciclada for extraida do pool. Da mesma forma, o método Deactivate é chamado sempre que o objeto é desativado, seja ele destruído ou retornado à piscina para reciclagem.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho comsvcs.h

Confira também

Pool de objetos COM+

Como funciona o pool de objetos

ObjectControl

Requisitos para objetos em pool