IAssemblyCache::InstallAssembly メソッド (winsxs.h)

  • [アーティクル]

InstallAssembly メソッドは、アセンブリへのアプリケーション参照をサイド バイ サイド ストアに追加し、アセンブリのファイルをサイド バイ サイド ストアにコピーします。 インストールされているアセンブリのファイルは、現在のファイル システムに存在する必要があります。

構文

HRESULT InstallAssembly(
  [in]           DWORD                       dwFlags,
  [in]           LPCWSTR                     pszManifestFilePath,
  [in, optional] LPCFUSION_INSTALL_REFERENCE pRefData
);

パラメーター

[in] dwFlags

このパラメーターは、サイド バイ サイド ストア内の既存のファイルを、インストールするアセンブリ内のファイルに置き換える方法を指定します。

次のいずれかのオプションを指定できます。

値 意味
IASSEMBLYCACHE_INSTALL_FLAG_REFRESH
 サイド バイ サイド ストア内の既存のファイルを、アセンブリ内のファイルのバージョンが既存のファイルのバージョン以上の場合は、インストールされているアセンブリ内のファイルに置き換えます。
IASSEMBLYCACHE_INSTALL_FLAG_FORCE_REFRESH
 サイド バイ サイド ストア内の既存のファイルを、インストールするアセンブリ内のファイルに置き換えます。

[in] pszManifestFilePath

アセンブリ マニフェストを含む動的リンク ライブラリ (DLL) または実行可能ファイル (EXE) ファイルへの完全パスを含む文字列値へのポインター。 その他のアセンブリ ファイルは、この DLL または EXE と同じディレクトリに配置する必要があります。

[in, optional] pRefData

インストールされているアセンブリへの参照を保持するアプリケーションを記述する FUSION_INSTALL_REFERENCE 構造体へのポインター。 このパラメーターが null の場合、アセンブリ ファイルはコピーされますが、アプリケーション参照はサイド バイ サイド ストアに追加されません。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

戻り値 説明
S_OK
 メソッドが成功しました。
S_FALSE
 メソッドが成功しませんでした。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winsxs.h
[DLL] Sxs.dll

こちらもご覧ください

IAssemblyCache