MsiReinstallFeatureA-Funktion (msi.h)

  • Artikel

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
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, die msidbFileAttributesChecksum in der Spalte Attributes der Tabelle File enthalten.
REINSTALLMODE_FILEREPLACE
 Erzwingt, dass alle Dateien unabhängig von der Prüfsumme oder Version neu installiert werden.
REINSTALLMODE_USERDATA
 Alle erforderlichen Registrierungseinträge aus der Registrierungstabelle , 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. 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.
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_FEATURE
 Die Feature-ID identifiziert kein bekanntes Feature.
ERROR_UNKNOWN_PRODUCT
 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

Installationen mit mehreren Paketen

REINSTALLMODE-Eigenschaft