MsiReinstallProductA-Funktion (msi.h)

Mit der MsiReinstallProduct-Funktion werden Produkte neu installiert.

Syntax

UINT MsiReinstallProductA(
  [in] LPCSTR szProduct,
  [in] DWORD  szReinstallMode
);

Parameter

[in] szProduct

Gibt den Produktcode für das Produkt an, das neu installiert werden soll.

[in] szReinstallMode

Gibt den Neuinstallationsmodus an. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert Bedeutung
REINSTALLMODE_FILEMISSING
Die Neuinstallation wird nur ausgeführt, wenn die Datei fehlt.
REINSTALLMODE_FILEOLDERVERSION
Die Neuinstallation wird ausgeführt, wenn die Datei fehlt oder es sich um eine ältere Version handelt.
REINSTALLMODE_FILEEQUALVERSION
Die Neuinstallation wird ausgeführt, wenn die Datei fehlt oder es sich um eine gleiche oder ältere Version handelt.
REINSTALLMODE_FILEEXACT
Installieren Sie neu, wenn die Datei fehlt oder eine andere Version ist.
REINSTALLMODE_FILEVERIFY
Überprüfen Sie die Prüfsummenwerte, und installieren Sie die Datei neu, wenn sie fehlen oder beschädigt sind. Dieses Flag repariert nur Dateien mit msidbFileAttributesChecksum in der Spalte Attribute der Dateitabelle.
REINSTALLMODE_FILEREPLACE
Erzwingt, dass alle Dateien unabhängig von der 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 eingefügt werden.
REINSTALLMODE_MACHINEDATA
Schreibt alle erforderlichen Registrierungseinträge aus der Registry-Tabelle neu, die in die HKEY_LOCAL_MACHINE-

oder HKEY_CLASSES_ROOT-

Registrierungsstruktur eingefügt werden. Schreiben Sie alle Informationen aus der Klassentabelle, der Verb-Tabelle, der PublishComponent-Tabelle, der ProgID-Tabelle, der MIMET-Tabelle, der Symboltabelle, der Erweiterungstabelle und der AppID-Tabelle unabhängig von der Computer- oder Benutzerzuweisung neu. Installieren Sie alle qualifizierten Komponenten neu.

Bei der Neuinstallation einer Anwendung führt diese Option die Aktionen RegisterTypeLibraries und InstallODBC aus.

REINSTALLMODE_SHORTCUT
Installiert alle Verknüpfungen neu, speichert alle Symbole erneut zwischen, und überschreibt vorhandene Verknüpfungen und Symbole.
REINSTALLMODE_PACKAGE
Wird zur Ausführung aus dem Quellpaket und erneuten Zwischenspeichern des lokalen Pakets verwendet. 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
Es wurde ein ungültiger Parameter an die Funktion ü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_PRODUCT
Der Produktcode identifiziert kein bekanntes Produkt.
 

Weitere Informationen finden Sie unter Angezeigte Fehlermeldungen.

Hinweise

Hinweis

Der msi.h-Header definiert MsiReinstallProduct 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (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 erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen.
Zielplattform Windows
Kopfzeile msi.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Installations- und Konfigurationsfunktionen

Installationen mit mehreren Paketen

REINSTALLMODE-Eigenschaft