IAssemblyCache::InstallAssembly-Methode (winsxs.h)

Artikel
03/04/2024

Die InstallAssembly-Methode fügt dem parallelen Speicher einen Anwendungsverweis auf eine Assembly hinzu und kopiert die Dateien der Assembly in den parallelen Speicher. Die Dateien der assembly, die installiert wird, müssen im aktuellen Dateisystem vorhanden sein.

Syntax

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

Parameter

[in] dwFlags

Dieser Parameter gibt an, wie vorhandene Dateien im parallelen Speicher durch Dateien in der zu installierenden Assembly ersetzt werden sollen.

Eine der folgenden Optionen kann angegeben werden.

Wert	Bedeutung
IASSEMBLYCACHE_INSTALL_FLAG_REFRESH	Ersetzen Sie vorhandene Dateien im parallelen Speicher durch die Dateien in der Assembly, die installiert wird, wenn die Version der Datei in der Assembly größer oder gleich der Version der vorhandenen Datei ist.
IASSEMBLYCACHE_INSTALL_FLAG_FORCE_REFRESH	Ersetzen Sie vorhandene Dateien im parallelen Speicher durch die Dateien in der Assembly, die installiert wird.

[in] pszManifestFilePath

Ein Zeiger auf einen Zeichenfolgenwert, der den vollständigen Pfad zur dynamisch verknüpften Bibliothek (DLL) oder ausführbaren Datei (EXE) enthält, die das Assemblymanifest enthält. Alle anderen Assemblydateien müssen sich im selben Verzeichnis wie diese DLL oder EXE befinden.

[in, optional] pRefData

Ein Zeiger auf eine FUSION_INSTALL_REFERENCE-Struktur , die die Anwendung beschreibt, die den Verweis auf die zu installierende Assembly enthält. Wenn dieser Parameter NULL ist, werden die Assemblydateien kopiert, aber dem parallelen Speicher wird kein Anwendungsverweis hinzugefügt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabewert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
S_FALSE	Die Methode war nicht erfolgreich.

Anforderungen

Anforderung	Wert
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