Função MTSCreateActivity (comsvcs.h)

  • Artigo

[MTSCreateActivity está disponível para nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use a função CoCreateActivity .]

Cria uma atividade em um apartment de thread único para fazer trabalhos em lote síncronos ou assíncronos.

Sintaxe

HRESULT MTSCreateActivity(
  [in]  REFIID riid,
  [out] void   **ppobj
);

Parâmetros

[in] riid

A ID da interface a ser retornada pelo parâmetro ppObj . Esse parâmetro sempre deve ser IID_IMTSActivity para que um ponteiro para IMTSActivity seja retornado.

[out] ppobj

Um ponteiro para a interface de um objeto de atividade. O objeto de atividade é criado automaticamente pela chamada para MTSCreateActivity.

Retornar valor

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

Comentários

MTSCreateActivity cria um objeto de atividade que é usado para enviar trabalho em lote para o sistema COM+. O trabalho em lote enviado por meio de MTSCreateActivity pode ser síncrono ou assíncrono e executado em um STA (single-threaded apartment).

MTSCreateActivity retorna um ponteiro para a interface IMTSActivity do objeto criado pela chamada para MTSCreateActivity. Usando os métodos de IMTSActivity, você determina se o trabalho em lote é feito de forma síncrona ou assíncrona. O trabalho em lote em si é implementado por meio da interface IMTSCall .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [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
Biblioteca ComSvcs.lib
DLL ComSvcs.dll

Confira também

CoCreateActivity