MsiReinstallFeatureA-Funktion (msi.h)
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 neu zu installierende Feature enthält.
[in] szFeature
Gibt das neu zu installierende Feature an. Das übergeordnete oder das untergeordnete Feature des angegebenen Features wird nicht neu installiert. Um das übergeordnete oder untergeordnete Feature 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 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, die msidbFileAttributesChecksum in der Spalte Attributes der Tabelle File enthalten. |
|
Erzwingt, dass alle Dateien unabhängig von der Prüfsumme oder Version neu installiert werden. |
|
Alle erforderlichen Registrierungseinträge aus der Registrierungstabelle , 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. Schreibt alle Informationen aus der Class-Tabelle, Verb-Tabelle, PublishComponent-Tabelle, ProgID-Tabelle, MIME-Tabelle, Icon-Tabelle, Extension-Tabelle und 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. |
|
Die Feature-ID identifiziert kein bekanntes Feature. |
|
Der Produktcode identifiziert kein bekanntes Produkt. |
Weitere Informationen finden Sie unter Angezeigte Fehlermeldungen.
Hinweise
Hinweis
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
| 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