ICLRRuntimeHost::ExecuteApplication メソッド
新しいドメインでアクティブ化するアプリケーションを指定するために、マニフェスト ベースの ClickOnce デプロイ シナリオで使用されます。 これらのシナリオの詳細については、「ClickOnce のセキュリティと配置」を参照してください。
構文
HRESULT ExecuteApplication(
[in] LPCWSTR pwzAppFullName,
[in] DWORD dwManifestPaths,
[in] LPCWSTR *ppwzManifestPaths,
[in] DWORD dwActivationData,
[in] LPCWSTR *ppwzActivationData,
[out] int *pReturnValue
);
パラメーター
pwzAppFullName
[in] ApplicationIdentity に定義されているアプリケーションの完全名。
dwManifestPaths
[in] ppwzManifestPaths
配列に格納されている文字列の数。
ppwzManifestPaths
[in] オプション。 アプリケーションのマニフェスト パスを格納する文字列配列。
dwActivationData
[in] ppwzActivationData
配列に格納されている文字列の数。
ppwzActivationData
[in] オプション。 Web に配置されたアプリケーションの URL のクエリ文字列部分など、アプリケーションのアクティベーション データを格納する文字列配列。
pReturnValue
[out アプリケーションのエントリ ポイントから返される値。
戻り値
HRESULT | 説明 |
---|---|
S_OK | ExecuteApplication が正常に返されました。 |
HOST_E_CLRNOTAVAILABLE | 共通言語ランタイム (CLR) がプロセスに読み込まれていないか、CLR がマネージド コードを実行できないまたは呼び出しを正常に処理できない状態です。 |
HOST_E_TIMEOUT | 呼び出しがタイムアウトになりました。 |
HOST_E_NOT_OWNER | 呼び出し元がロックを所有していません。 |
HOST_E_ABANDONED | ブロックされたスレッドまたはファイバーが待機しているときに、イベントが取り消されました。 |
E_FAIL | 原因不明の致命的なエラーが発生しました。 メソッドにより E_FAIL が返されると、そのプロセス内で CLR が使用できなくなります。 後続のホスティング メソッドの呼び出しでは HOST_E_CLRNOTAVAILABLE が返されます。 |
解説
ExecuteApplication
は、新しく作成されたアプリケーション ドメインで ClickOnce アプリケーションをアクティブ化するために使用されます。
pReturnValue
出力パラメーターは、アプリケーションによって返される値に設定されます。 pReturnValue
に null 値を指定した場合、ExecuteApplication
は失敗しませんが、値を返しません。
重要
ExecuteApplication
メソッドを呼び出してマニフェストベースのアプリケーションをアクティブ化する前に、Start Method メソッドを呼び出さないでください。 Start
メソッドが最初に呼び出された場合、ExecuteApplication
メソッドの呼び出しは失敗します。
必要条件
:「システム要件」を参照してください。
ヘッダー: MSCorEE.h
ライブラリ: MSCorEE.dll にリソースとして含まれます
.NET Framework のバージョン: 2.0 以降で使用可能
関連項目
.NET