ICLRRuntimeHost::ExecuteApplication メソッド

2011-08-09

新しいドメインでアクティブにするアプリケーションを指定するために、マニフェストベースの ClickOnce 配置シナリオで使用されます。これらのシナリオの詳細については、「ClickOnce のセキュリティと配置」を参照してください。

HRESULT ExecuteApplication(
    [in] LPCWSTR   pwzAppFullName,
    [in] DWORD     dwManifestPaths,
    [in] LPCWSTR   *ppwzManifestPaths,
    [in] DWORD     dwActivationData,
    [in] LPCWSTR   *ppwzActivationData,
    [out] int      *pReturnValue
);

パラメーター

pwzAppFullName
[入力] ApplicationIdentity に定義されているとおりのアプリケーションの完全名。
dwManifestPaths
[入力] ppwzManifestPaths 配列に含まれる文字列の数。
ppwzManifestPaths
[入力] 省略可能。アプリケーションのマニフェストのパスを含む文字列配列。
dwActivationData
[入力] ppwzActivationData 配列に含まれる文字列の数。
ppwzActivationData
[入力] 省略可能。アプリケーションのアクティベーションデータを含む文字列配列。Web に配置されているアプリケーションの URL のクエリ文字列部分などがこれにあたります。
pReturnValue
[出力] アプリケーションのエントリポイントから返される値。

戻り値

HRESULT	説明
S_OK	ExecuteApplication が正常に終了しました。
HOST_E_CLRNOTAVAILABLE	共通言語ランタイム (CLR: Common Language Runtime) がプロセスに読み込まれていません。または CLR がマネージコードを実行できない状態か、呼び出しを正常に処理できない状態にあります。
HOST_E_TIMEOUT	呼び出しがタイムアウトしました。
HOST_E_NOT_OWNER	呼び出し元がロックを所有していません。
HOST_E_ABANDONED	ブロックされたスレッドまたはファイバーが待機しているイベントがキャンセルされました。
E_FAIL	未知の重大エラーが発生しました。メソッドから E_FAIL が返される場合、プロセス内で CLR を使用することはできません。ホストメソッドへの後続の呼び出しで、HOST_E_CLRNOTAVAILABLE が返されます。

解説

新しく作成されたアプリケーションドメインで ClickOnce アプリケーションをアクティブ化するには、ExecuteApplication を使用します。

pReturnValue 出力パラメーターは、アプリケーションから返される値に設定されます。 pReturnValue に null 値を指定しても ExecuteApplication は失敗しませんが、値は返されません。

重要
ExecuteApplication メソッドを呼び出してマニフェストベースのアプリケーションをアクティブにする前に ICLRRuntimeHost::Start メソッドメソッドを呼び出さないでください。Start メソッドを最初に呼び出すと、ExecuteApplication メソッドの呼び出しは失敗します。

必要条件

プラットフォーム: 「.NET Framework システム要件」を参照

ヘッダー : MSCorEE.h

ライブラリ: MSCorEE.dll にリソースとして格納されていること

.NET Framework のバージョン: 4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0

参照

次の方法で共有

ICLRRuntimeHost::ExecuteApplication メソッド

パラメーター

戻り値

解説

必要条件

参照

処理手順

参照

概念

その他のリソース