Funzione MTSCreateActivity (comsvcs.h)

[MTSCreateActivity è disponibile per nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece la funzione CoCreateActivity .]

Crea un'attività in un apartment a thread singolo per eseguire operazioni batch sincrone o asincrone.

Sintassi

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

Parametri

[in] riid

ID dell'interfaccia da restituire dal parametro ppObj . Questo parametro deve essere sempre IID_IMTSActivity in modo che venga restituito un puntatore a IMTSActivity .

[out] ppobj

Puntatore all'interfaccia di un oggetto attività. L'oggetto attività viene creato automaticamente dalla chiamata a MTSCreateActivity.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY, E_FAIL e S_OK.

Commenti

MTSCreateActivity crea un oggetto attività usato per inviare operazioni batch al sistema COM+. Il lavoro batch inviato tramite MTSCreateActivity può essere sincrono o asincrono ed eseguito in un apartment a thread singolo (STA).

MTSCreateActivity restituisce un puntatore all'interfaccia IMTSActivity dell'oggetto creato dalla chiamata a MTSCreateActivity. Usando i metodi di IMTSActivity, si determina se il lavoro batch viene eseguito in modo sincrono o asincrono. Il lavoro batch stesso viene implementato tramite l'interfaccia IMTSCall .

Requisiti

Vedi anche

CoCreateActivity