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 以降で使用可能

関連項目