Share via


IAssemblyCache::InstallAssembly-Methode (winsxs.h)

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