Partager via


Méthode IAssemblyCache ::InstallAssembly (winsxs.h)

La méthode InstallAssembly ajoute une référence d’application à un assembly au magasin côte à côte et copie les fichiers de l’assembly dans le magasin côte à côte. Les fichiers de l’assembly en cours d’installation doivent être présents dans le système de fichiers actuel.

Syntaxe

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

Paramètres

[in] dwFlags

Ce paramètre spécifie comment les fichiers existants dans le magasin côte à côte doivent être remplacés par les fichiers de l’assembly en cours d’installation.

L’une des options suivantes peut être spécifiée.

Valeur Signification
IASSEMBLYCACHE_INSTALL_FLAG_REFRESH
Remplacez les fichiers existants dans le magasin côte à côte par les fichiers de l’assembly en cours d’installation si la version du fichier dans l’assembly est supérieure ou égale à la version du fichier existant.
IASSEMBLYCACHE_INSTALL_FLAG_FORCE_REFRESH
Remplacez les fichiers existants dans le magasin côte à côte par les fichiers de l’assembly en cours d’installation.

[in] pszManifestFilePath

Pointeur vers une valeur de chaîne qui contient le chemin d’accès complet à la bibliothèque liée dynamique (DLL) ou au fichier exécutable (EXE) qui contient le manifeste d’assembly. Tous les autres fichiers d’assembly doivent se trouver dans le même répertoire que cette DLL ou EXE.

[in, optional] pRefData

Pointeur vers une structure FUSION_INSTALL_REFERENCE qui décrit l’application qui contient la référence à l’assembly en cours d’installation. Si ce paramètre a la valeur Null, les fichiers d’assembly sont copiés, mais aucune référence d’application n’est ajoutée au magasin côte à côte.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur retournée Description
S_OK
S_OK
S_FALSE
La méthode n’a pas réussi.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winsxs.h
DLL Sxs.dll

Voir aussi

IAssemblyCache