MsiReinstallFeatureA-Funktion (msi.h)

Artikel
11/20/2024

Die MsiReinstallFeature Funktion installiert Features neu.

Syntax

UINT MsiReinstallFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwReinstallMode
);

Parameter

[in] szProduct

Gibt den Produktcode für das Produkt an, das das Feature enthält, das neu installiert werden soll.

[in] szFeature

Gibt das Feature an, das neu installiert werden soll. Das übergeordnete Feature oder untergeordnete Feature des angegebenen Features wird nicht neu installiert. Um das Feature für das übergeordnete oder untergeordnete Element neu zu installieren, müssen Sie die MsiReinstallFeature-funktion für jede separat aufrufen oder die MsiReinstallProduct-Funktion verwenden.

[in] dwReinstallMode

Gibt an, was installiert werden soll. Dieser Parameter kann einen oder mehrere der folgenden Werte sein.

Wert	Bedeutung
REINSTALLMODE_FILEMISSING	Installieren Sie nur erneut, wenn die Datei fehlt.
REINSTALLMODE_FILEOLDERVERSION	Installieren Sie erneut, wenn die Datei fehlt oder eine ältere Version ist.
REINSTALLMODE_FILEEQUALVERSION	Installieren Sie erneut, wenn die Datei fehlt oder eine gleiche oder ältere Version ist.
REINSTALLMODE_FILEEXACT	Installieren Sie erneut, wenn die Datei fehlt oder eine andere Version ist.
REINSTALLMODE_FILEVERIFY	Überprüfen Sie die Prüfsummenwerte, und installieren Sie die Datei erneut, wenn sie fehlen oder beschädigt sind. Dieses Flag repariert nur Dateien mit msidbFileAttributesChecksum in der Spalte "Attribute" der Dateitabelle.
REINSTALLMODE_FILEREPLACE	Erzwingen Sie, dass alle Dateien unabhängig von Prüfsumme oder Version neu installiert werden.
REINSTALLMODE_USERDATA	Schreiben Sie alle erforderlichen Registrierungseinträge aus der Registrierungstabelle neu die zum HKEY_CURRENT_USER oder HKEY_USERS Registrierungsstruktur.
REINSTALLMODE_MACHINEDATA	Schreiben Sie alle erforderlichen Registrierungseinträge aus der Registrierungstabelle, die zum HKEY_LOCAL_MACHINE oder HKEY_CLASSES_ROOT Registrierungsstruktur. Schreiben Sie alle Informationen aus der Class Table, Verb Table, PublishComponent Table, ProgID Table, MIME Table, Icon Table, Extension Table, und AppID Table unabhängig von Computer- oder Benutzerzuweisung. Installieren Sie alle qualifizierten Komponentenneu. Beim erneuten Installieren einer Anwendung führt diese Option die RegisterTypeLibraries und InstallODBC- Aktionen aus.
REINSTALLMODE_SHORTCUT	Installieren Sie alle Verknüpfungen neu, und speichern Sie alle Symbole neu, um alle vorhandenen Verknüpfungen und Symbole zu überschreiben.
REINSTALLMODE_PACKAGE	Wird verwendet, um aus dem Quellpaket auszuführen und das lokale Paket erneut zwischenzuspeichern. Verwenden Sie nicht für die erste Installation einer Anwendung oder eines Features.

Rückgabewert

Rückgabecode	Beschreibung
ERROR_INSTALL_FAILURE	Fehler bei der Installation.
ERROR_INVALID_PARAMETER	An die Funktion wurde ein ungültiger Parameter übergeben.
ERROR_INSTALL_SERVICE_FAILURE	Auf den Installationsdienst konnte nicht zugegriffen werden.
ERROR_INSTALL_SUSPEND	Die Installation wurde angehalten und ist unvollständig.
ERROR_INSTALL_USEREXIT	Der Benutzer hat die Installation abgebrochen.
ERROR_SUCCESS	Die Funktion wurde erfolgreich abgeschlossen.
ERROR_UNKNOWN_FEATURE	Die Feature-ID identifiziert kein bekanntes Feature.
ERROR_UNKNOWN_PRODUCT	Der Produktcode identifiziert kein bekanntes Produkt.

Weitere Informationen finden Sie unter Angezeigte Fehlermeldungen.

Bemerkungen

Anmerkung

Der msi.h-Header definiert MsiReinstallFeature als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP. Informationen zum mindestens von einer Windows Installer-Version erforderlichen Windows-Service Pack finden Sie unter den Windows Installer-Run-Time Anforderungen.
Zielplattform-	Fenster
Header-	msi.h
Library	Msi.lib
DLL-	Msi.dll

Siehe auch

Installations- und Konfigurationsfunktionen

Multiple-Package Installationen

REINSTALLMODE-Eigenschaft

Freigeben über