Função MTSCreateActivity (comsvcs.h)
[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 |