CoCreateActivity 関数 (comsvcs.h)

[アーティクル]
08/22/2023

COM+ コンポーネントを作成せずに COM+ サービスを使うことができる、同期または非同期のバッチ作業を実行するためのアクティビティを作成します。

構文

HRESULT CoCreateActivity(
  [in]  IUnknown *pIUnknown,
  [in]  REFIID   riid,
  [out] void     **ppObj
);

パラメーター

[in] pIUnknown

CoCreateActivity によって作成されたアクティビティ内で使用されるサービスの構成情報を含む、CServiceConfig クラスから作成されたオブジェクトの IUnknown インターフェイスへのポインター。

[in] riid

ppObj パラメーターを使用して返されるインターフェイスの ID。 IServiceActivity へのポインターが返されるように、このパラメーターは常にIID_IServiceActivityする必要があります。

[out] ppObj

アクティビティオブジェクトのインターフェイスへのポインター。アクティビティオブジェクトは、 CoCreateActivity の呼び出しによって自動的に作成されます。

戻り値

このメソッドは、E_INVALIDARG、E_OUTOFMEMORY、E_FAILの標準戻り値と、次の値を返すことができます。

リターンコード	説明
S_OK	メソッドは正常に完了しました。
CO_E_SXS_CONFIG	CServiceConfig オブジェクトのサイドバイサイドアセンブリ構成が無効です。
CO_E_THREADPOOL_CONFIG	CServiceConfig オブジェクトのスレッドプール構成が無効です。
CO_E_TRACKER_CONFIG	CServiceConfig オブジェクトのトラッカー構成が無効です。
COMADMIN_E_PARTITION_ACCESSDENIED	呼び出し元には、COM+ パーティションに対するアクセス許可がありません。

注釈

CoCreateActivity は、COM+ システムにバッチ作業を送信するために使用されるアクティビティオブジェクトを作成します。アクティビティに関連付けられているコンテキストは、pIUnknown パラメーターを介して渡される CServiceConfig オブジェクトによって完全に決定されます。

CoCreateActivity を使用すると、アプリケーションは、それらのサービスを使用するコンポーネントを作成しなくても、バッチ処理で COM+ サービスを使用できます。 CoCreateActivity を使用すると、コンポーネントの作成が不要になるため、オーバーヘッドを削減するだけでなく、COM+ 登録データベース (RegDB) に格納されている情報にアクセスすることなくアプリケーション全体のサービス構成をサポートできるため、より効率的なランタイム環境が提供されます。

CoCreateActivity を介して送信されるバッチ作業は、同期または非同期のいずれかであり、シングルスレッドアパートメント (STA) またはマルチスレッドアパートメント (MTA) で実行できます。使用されるスレッドモデルは、pIUnknown パラメーターを介して渡される CServiceConfig オブジェクトの IServiceThreadPoolConfig インターフェイスによって決定されます。

CoCreateActivity は、CoCreateActivity の呼び出しによって作成されたオブジェクトの IServiceActivity インターフェイスへのポインターを返します。 IServiceActivity のメソッドを使用して、バッチ処理が同期的に行われるか非同期的に行われるかを判断します。バッチ処理自体は、 IServiceCall インターフェイスを介して実装されます。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	comsvcs.h
Library	ComSvcs.lib
[DLL]	ComSvcs.dll