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 |
|---|---|
|
Die Neuinstallation wird nur ausgeführt, wenn die Datei fehlt. |
|
Die Neuinstallation wird ausgeführt, wenn die Datei fehlt oder es sich um eine ältere Version handelt. |
|
Die Neuinstallation wird ausgeführt, wenn die Datei fehlt oder es sich um eine gleiche oder ältere Version handelt. |
|
Installieren Sie neu, wenn die Datei fehlt oder eine andere Version ist. |
|
Ü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. |
|
Erzwingt, dass alle Dateien unabhängig von der Prüfsumme oder Version neu installiert werden. |
|
Schreiben Sie alle erforderlichen Registrierungseinträge aus der Registrierungstabelle neu, die zum HKEY_CURRENT_USER oder HKEY_USERS- Registrierungsstruktur eingefügt werden. |
|
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. |
|
Installiert alle Verknüpfungen neu, speichert alle Symbole erneut zwischen, und überschreibt vorhandene Verknüpfungen und Symbole. |
|
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 |
|---|---|
|
Fehler bei der Installation. |
|
Es wurde ein ungültiger Parameter an die Funktion übergeben. |
|
Auf den Installationsdienst konnte nicht zugegriffen werden. |
|
Die Installation wurde angehalten und ist unvollständig. |
|
Der Benutzer hat die Installation abgebrochen. |
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
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