MsiReinstallProductA-Funktion (msi.h)
Die MsiReinstallProduct Funktion installiert Produkte neu.
Syntax
UINT MsiReinstallProductA(
[in] LPCSTR szProduct,
[in] DWORD szReinstallMode
);
Parameter
[in] szProduct
Gibt den Produktcode an, mit dem das Produkt neu installiert werden soll.
[in] szReinstallMode
Gibt den Neuinstallationsmodus an. Dieser Parameter kann einen oder mehrere der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Installieren Sie nur erneut, wenn die Datei fehlt. |
|
Installieren Sie erneut, wenn die Datei fehlt oder eine ältere Version ist. |
|
Installieren Sie erneut, wenn die Datei fehlt oder eine gleiche oder ältere Version ist. |
|
Installieren Sie erneut, wenn die Datei fehlt oder eine andere Version ist. |
|
Ü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. |
|
Erzwingen Sie, dass alle Dateien unabhängig von 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. |
|
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, MIMET Table, Icon Table, Erweiterungstabelleund AppID-Tabelle 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. |
|
Installieren Sie alle Verknüpfungen neu, und speichern Sie alle Symbole neu, um alle vorhandenen Verknüpfungen und Symbole zu überschreiben. |
|
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 |
|---|---|
|
Fehler bei der Installation. |
|
An die Funktion wurde ein ungültiger Parameter ü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.
Bemerkungen
Anmerkung
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 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 |