IAssemblyCache::UninstallAssembly-Methode (winsxs.h)

Artikel
08/27/2023

Die UnistallAssembly-Methode entfernt einen Anwendungsverweis auf eine Assembly aus dem parallelen Speicher. Wenn keine anderen Verweise von anderen Anwendungen auf die Assembly vorhanden sind, kann die Assembly nicht mehr verwendet werden. Windows kann die Dateien der Assembly aus dem parallelen Speicher entfernen und speicherplatz zu einem späteren Zeitpunkt wieder freigeben.

Syntax

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

Parameter

[in] dwFlags

Dieser Parameter muss 0 sein.

[in] pszAssemblyName

Ein Zeiger auf einen null-beendeten Zeichenfolgenwert, der den vollständig angegebenen starken Namen der Assembly enthält. Wenn der vollständige Name nicht angegeben wird, ist das Ergebnis nicht definiert.

[in] pRefData

Ein Zeiger auf eine FUSION_INSTALL_REFERENCE Struktur, die die Anwendung beschreibt, die den Verweis auf die zu entfernende Assembly enthält. Wenn dieser Wert NULL ist, werden keine Verweise auf die Assembly von Anwendungen im parallelen Speicher verbleiben, und die Dateien der Assembly werden entfernt.

Hinweis Die Zeichen \, /, :, ;, *, <, , >und | sind in der Verweis-ID ungültig.

[out, optional] pulDisposition

Ein Zeiger auf einen ganzzahligen Wert, der die ausgeführte Aktion beschreibt.

Der pulDisposition-Parameter kann einen der folgenden Werte oder NULL enthalten.

Wert	Bedeutung
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_UNINSTALLED	Die Assemblydateien wurden aus dem parallelen Speicher entfernt.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_STILL_IN_USE	Die Dateien der Assembly wurden nicht entfernt, da eine Anwendung die Assembly verwendet.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_ALREADY_UNINSTALLED	Die Assembly ist nicht im parallelen Speicher vorhanden.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_DELETE_PENDING	Reserviert.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_HAS_INSTALL_REFERENCES	Die Dateien der Assembly wurden nicht entfernt, da der parallele Speicher einen Verweis auf die Assembly durch eine andere Anwendung enthält.
IASSEMBLYCACHE_UNINSTALL_DISPOSITION_REFERENCE_NOT_FOUND	Der in pRefData angegebene Verweis ist im parallelen Speicher nicht vorhanden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabewert	BESCHREIBUNG
S_OK	Die Dateien der Assembly wurden aus dem parallelen Speicher entfernt.
S_FALSE	Der Vorgang war erfolgreich, und der Verweis auf die Assembly wurde entfernt. Die Assemblydateien wurden aus dem parallelen Speicher aus dem grund nicht entfernt, der durch den von pulDisposition zurückgegebenen Wert beschrieben wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winsxs.h
DLL	Sxs.dll

Weitere Informationen

Iassemblycache

Freigeben über