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

こちらもご覧ください

ICOMAdminCatalog2