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

Article
03/13/2024

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

Partager via