ICOMAdminCatalog2::CreateServiceForApplication メソッド (comadmin.h)
Windows サービスとして実行するように COM+ アプリケーションを構成します。
構文
HRESULT CreateServiceForApplication(
[in] BSTR bstrApplicationIDOrName,
[in] BSTR bstrServiceName,
[in] BSTR bstrStartType,
[in] BSTR bstrErrorControl,
[in] BSTR bstrDependencies,
[in] BSTR bstrRunAs,
[in] BSTR bstrPassword,
[in] VARIANT_BOOL bDesktopOk
);
パラメーター
[in] bstrApplicationIDOrName
アプリケーション ID またはアプリケーションの名前。
[in] bstrServiceName
アプリケーションのサービス名。 この名前は、表示名ではなく、サービス 制御マネージャー (SCM) によって使用される内部名です。
[in] bstrStartType
サービスを開始するタイミング。 有効な引数は、CreateService 関数の dwStartType パラメーターのオプションです。 引数は引用符で囲む必要があります。 有効な引数は、SERVICE_BOOT_START、SERVICE_SYSTEM_START、SERVICE_AUTO_START、SERVICE_DEMAND_START、SERVICE_DISABLEDです。
[in] bstrErrorControl
起動時にこのサービスの起動に失敗した場合のエラーの重大度。 エラーは、エラーが発生した場合にスタートアップ プログラムによって実行されるアクションを決定します。 有効な引数は、CreateService 関数の dwErrorControl パラメーターのオプションです。 引数は引用符で囲む必要があります。 有効な引数は、SERVICE_ERROR_IGNORE、SERVICE_ERROR_NORMAL、SERVICE_ERROR_SEVERE、SERVICE_ERROR_CRITICALです。
[in] bstrDependencies
サービスの依存関係の一覧。 文字列には、標準の null で区切られた二重 null で終わる文字列 ( CreateService に関するドキュメントに記載されているとおり) の 2 つの形式があります。または、"" で区切られたサービス名のスクリプトフレンドリリスト (サービス名に含まれる無効な文字)。 rpcss サービスはこのパラメーターで暗黙的であり、指定する必要はありません。
[in] bstrRunAs
このサービスを実行するユーザー名。 このパラメーターが NULL の場合、サービスはローカル サービスとして実行されます。
[in] bstrPassword
システム ユーザー アカウントのパスワード。 サービスがローカル サービスとして実行されるように構成されている場合、このパラメーターは NULL である必要があります。
[in] bDesktopOk
サービスがデスクトップとの対話を許可される必要があるかどうかを示します。 このパラメーターは、サービスがローカル サービスとしてマークされ、それ以外の場合は FALSE である必要がある場合にのみ有効です。
戻り値
このメソッドは、E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL、S_OKの標準戻り値を返すことができます。
注釈
このメソッドによって作成されたサービスは、 DeleteServiceForApplication メソッドを使用して削除できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | comadmin.h |