Método IServiceCall::OnCall (comsvcs.h)

Dispara a execução do trabalho em lotes implementado neste método.

Sintaxe

HRESULT OnCall();

Valor retornado

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

Comentários

O trabalho em lote executado nesse método é executado no contexto e no thread apartment da atividade que foi criada pela chamada para CoCreateActivity. O trabalho em lote nesse método é executado por meio de uma chamada para SynchronousCall ou AsynchronousCall, usando o ponteiro IServiceActivity que foi retornado da chamada para CoCreateActivity.

Você deve verificar se esse método é thread-safe em situações em que o objeto de atividade criado por CoCreateActivity não é criado com um contexto sincronizado porque, nessas situações, muitas chamadas para OnCall podem ser executadas ao mesmo tempo.

Para obter o melhor desempenho do sistema, a configuração de contexto da atividade criada por CoCreateActivity deve ser correspondida ao trabalho em lotes executado pelo método OnCall . Por exemplo, se o trabalho em lote no método OnCall usar objetos em pool, a atividade criada por CoCreateActivity deverá ser configurada para usar o MTA (multithreaded apartment).

Requisitos

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

Confira também

Iservicecall