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