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

Article
03/15/2023

La méthode UnistallAssembly supprime une référence d’application à un assembly du magasin côte à côte. S’il n’existe aucune autre référence à l’assembly par d’autres applications, l’assembly devient inutilisable. Windows peut supprimer les fichiers de l’assembly du magasin côte à côte et récupérer de l’espace disque ultérieurement.

Syntaxe

HRESULT UninstallAssembly(
  [in]            DWORD                       dwFlags,
  [in]            LPCWSTR                     pszAssemblyName,
  [in]            LPCFUSION_INSTALL_REFERENCE pRefData,
  [out, optional] ULONG                       *pulDisposition
);

Paramètres

[in] dwFlags

Ce paramètre doit être 0.

[in] pszAssemblyName

Pointeur vers une valeur de chaîne terminée par null qui contient le nom fort entièrement spécifié de l’assembly. Si le nom complet n’est pas fourni, le résultat n’est pas défini.

[in] pRefData

Pointeur vers une structure FUSION_INSTALL_REFERENCE qui décrit l’application qui contient la référence à l’assembly supprimé. Si cette valeur est null, aucune référence à l’assembly par les applications n’est conservée dans le magasin côte à côte et les fichiers de l’assembly sont supprimés.

Note Les caractères \, /, :, ;, *, <, >, et | ne sont pas valides dans l’ID de référence.

[out, optional] pulDisposition

Pointeur vers une valeur entière qui décrit l’action effectuée.

Le paramètre pulDisposition peut contenir l’une des valeurs suivantes ou null.

Valeur	Signification
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_UNINSTALLED	Les fichiers d’assembly ont été supprimés du magasin côte à côte.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_STILL_IN_USE	Les fichiers de l’assembly n’ont pas été supprimés, car une application utilise l’assembly.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_ALREADY_UNINSTALLED	L’assembly n’existe pas dans le magasin côte à côte.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_DELETE_PENDING	Réservé.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_HAS_INSTALL_REFERENCES	Les fichiers de l’assembly n’ont pas été supprimés, car le magasin côte à côte contient une référence à l’assembly par une autre application.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_REFERENCE_NOT_FOUND	La référence spécifiée dans pRefData n’existe pas dans le magasin côte à côte.

Valeur retournée

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

Valeur retournée	Description
S_OK	Les fichiers de l’assembly ont été supprimés du magasin côte à côte.
S_FALSE	L’opération a réussi et la référence à l’assembly a été supprimée. Les fichiers d’assembly n’ont pas été supprimés du magasin côte à côte pour la raison décrite par la valeur retournée par pulDisposition.

Configuration requise


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