MsiInstallProductA-Funktion (msi.h)

  • Artikel

Die MsiInstallProduct-Funktion installiert oder deinstalliert ein Produkt.

Syntax

UINT MsiInstallProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szCommandLine
);

Parameter

[in] szPackagePath

Eine NULL-beendete Zeichenfolge, die den Pfad zum Speicherort des Windows Installer-Pakets angibt. Der Zeichenfolgenwert kann eine URL (z. B. http://packageLocation/package/package.msi), einen Netzwerkpfad (z. B. \packageLocation\package.msi), einen Dateipfad (z. B. file://packageLocation/package.msi) oder einen lokalen Pfad (z. B. D:\packageLocation\package.msi) enthalten.

[in] szCommandLine

Eine NULL-beendete Zeichenfolge, die die Befehlszeileneigenschafteneinstellungen angibt. Dies sollte eine Liste des Formats Property=Setting Property=Setting sein. Weitere Informationen hierzu finden Sie unter Informationen zu Eigenschaften.

Um eine administratorische Installation durchzuführen, schließen Sie ACTION=ADMIN in szCommandLine ein. Weitere Informationen finden Sie unter der ACTION-Eigenschaft.

Rückgabewert

Wert Bedeutung
ERROR_SUCCESS
 Die Funktion wird erfolgreich abgeschlossen.
Fehler im Zusammenhang mit einer Aktion
 Weitere Informationen finden Sie unter Fehlercodes.
Initialisierungsfehler
 Ein Fehler, der sich auf die Initialisierung bezieht, ist aufgetreten.
 

Weitere Informationen finden Sie unter Angezeigte Fehlermeldungen.

Hinweise

Die MsiInstallProduct-Funktion zeigt die Benutzeroberfläche mit den aktuellen Einstellungen und dem Protokollmodus an.

Weitere Informationen finden Sie unter REMOVE-Eigenschaft .

Hinweis

Der msi.h-Header definiert MsiInstallProduct 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. Informationen zum minimal 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

Angezeigte Fehlermeldungen

Fehlercodes

Initialisierungsfehler

Installations- und Konfigurationsfunktionen

Installationen mit mehreren Paketen