IAssemblyCache::InstallAssembly method (winsxs.h)

The InstallAssembly method adds an application reference to an assembly to the side-by-side store and copies the files of the assembly to the side-by-side store. The files of the assembly being installed must be present in the current file system.

Syntax

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

Parameters

[in] dwFlags

This parameter specifies how existing files in the side-by-side store are to replaced by files in the assembly being installed.

One of the following options can be specified.

Value	Meaning
IASSEMBLYCACHE_INSTALL_FLAG_REFRESH	Replace existing files in the side-by-side store with the files in the assembly being installed if the version of the file in the assembly is greater than or equal to the version of the existing file.
IASSEMBLYCACHE_INSTALL_FLAG_FORCE_REFRESH	Replace existing files in the side-by-side store with the files in the assembly being installed.

[in] pszManifestFilePath

A pointer to a string value that contains the full path to the dynamic-linked library (DLL) or executable (EXE) file that contains the assembly manifest. Any other assembly files must be located in the same directory as this DLL or EXE.

[in, optional] pRefData

A pointer to a FUSION_INSTALL_REFERENCE structure that describes the application that holds the reference to the assembly being installed. If this parameter is null, the assembly files are copied, but no application reference is added to the side-by-side store.

Return value

This method can return one of these values.

Return value	Description
S_OK	The method succeeded.
S_FALSE	The method did not succeed.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	winsxs.h
DLL	Sxs.dll

See also

IAssemblyCache