IProcessInitializer

.NET Framework クラス ライブラリ リファレンス

IProcessInitializer インターフェイス

COM コンポーネントの起動時または終了時に呼び出すことができるメソッドをサポートします。

名前空間: System.EnterpriseServices
アセンブリ: System.EnterpriseServices (system.enterpriseservices.dll 内)
構文

Visual Basic (宣言)

<GuidAttribute("1113f52d-dc7f-4943-aed6-88d04027e32a")>
 _
<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)> _
Public Interface IProcessInitializer

Visual Basic (使用法)

Dim instance As IProcessInitializer

C#

[GuidAttribute("1113f52d-dc7f-4943-aed6-88d04027e32a")] 
[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)] 
public interface IProcessInitializer

C++

[GuidAttribute(L"1113f52d-dc7f-4943-aed6-88d04027e32a")] 
[InterfaceTypeAttribute(ComInterfaceType::InterfaceIsIUnknown)] 
public interface class IProcessInitializer

J#

/** @attribute GuidAttribute("1113f52d-dc7f-4943-aed6-88d04027e32a") */
 
/** @attribute InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown) */ 
public interface IProcessInitializer

JScript

GuidAttribute("1113f52d-dc7f-4943-aed6-88d04027e32a") 
InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown) 
public interface IProcessInitializer

解説

サーバー プロセス (Dllhost.exe) の起動時に初期化コードを実行する必要がある場合や、サーバー プロセスの終了時に終了コードを実行する必要がある場合は、サービス コンポーネントに IProcessInitializer インターフェイス メソッドを実装します。

COM+ は、Dllhost.exe の起動時に Startup イベントを発生させ、Dllhost.exe の終了時に Shutdown イベントを発生させます。この機能により、COM+ サーバー アプリケーション (以下、「サーバー コンポーネント」とします) 内にインストールされた任意の COM+ コンポーネントが、初期化やクリーンアップのためのカスタム コードを実行することが可能になります。IProcessInitializer インターフェイスを実装する各コンポーネントのインスタンスは、プロセスの存続期間中に作成されて保存され、起動および終了の処理中にそのインターフェイス メソッドが呼び出されます。ServicedComponent に実装した場合、コンポーネントの登録中に、Components コレクション内の COMAdminCatalogObject の InitializesServerApplication パラメータが true に設定されます。

Startup イベントと Shutdown イベントを使用すると、リソースの初期化、接続の作成、共有データの初期化、およびクリーンアップ コードを実行できます。ただし、サーバー コンポーネントのインスタンスはまだ作成されていないため、COM+ の特定の状態にはアクセスしないでください。さらに、システムはプロセスを起動した後 Dllhost.exe がアクティベーションを受け入れる準備を終えるまでに 90 秒間しか待たないため、Startup イベントと Shutdown イベントのコードは可能な限りすばやく制御を返す必要があります。Dllhost.exe が 90 秒以内に準備が整ったことを通知しないと、システムがプロセスを終了させるため、すべての初期化処理をこの時間内に完了させる必要があります。初期化に参加する各サーバー コンポーネントが、IProcessInitializer インターフェイスをサポートする必要があります。DllHost.exe の起動時には、COM+ は、このサービスを要求したすべてのサーバー コンポーネントを作成し、IProcessInitializer インターフェイスの QueryInterface を呼び出し、Startup 関数を呼び出します。同様に、DllHost.exe プロセスの終了時には、これらの以前に格納したインターフェイスのポインタで Shutdown 関数を呼び出します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
IProcessInitializer メンバ
System.EnterpriseServices 名前空間

IProcessInitializer メソッド

パブリック メソッド

	名前	説明
	Shutdown	終了アクションを実行します。Dllhost.exe の終了時に呼び出されます。
	Startup	起動時の初期化を実行します。Dllhost.exe の起動時に呼び出されます。

参照

関連項目

IProcessInitializer インターフェイス
System.EnterpriseServices 名前空間

IProcessInitializer メンバ

COM コンポーネントの起動時または終了時に呼び出すことができるメソッドをサポートします。

IProcessInitializer データ型で公開されるメンバを以下の表に示します。

パブリック メソッド

	名前	説明
	Shutdown	終了アクションを実行します。Dllhost.exe の終了時に呼び出されます。
	Startup	起動時の初期化を実行します。Dllhost.exe の起動時に呼び出されます。

参照

関連項目

IProcessInitializer インターフェイス
System.EnterpriseServices 名前空間