MTSCreateActivity 函式 (comsvcs.h)

[MTSCreateActivity 適用於需求一節中指定的操作系統。它在後續版本中可能會變更或無法使用。請改用 CoCreateActivity 函式。]

在單個線程 Apartment 中建立活動，以執行同步或異步批次工作。

語法

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

[in] riid

ppObj 參數所傳回之介面的標識碼。此參數應該一律IID_IMTSActivity，以便傳回 IMTSActivity 的指標。

[out] ppobj

活動物件的介面指標。活動物件是由 MTSCreateActivity 的呼叫自動建立。

這個方法可以傳回標準傳回值E_INVALIDARG、E_OUTOFMEMORY、E_FAIL和S_OK。

MTSCreateActivity 會建立活動物件，用來將批次工作提交至 COM+ 系統。透過 MTSCreateActivity 提交的批次工作可以是同步或異步的，而且會在單一線程 Apartment 中執行， (STA) 。

MTSCreateActivity 會傳回呼叫 MTSCreateActivity 所建立之物件的 IMTSActivity 介面指標。藉由使用 IMTSActivity 的方法，您可以判斷批次工作是以同步或異步方式完成。批次工作本身是透過 IMTSCall 介面實作。