MsiInstallProductA-Funktion (msi.h)
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 |
|---|---|
|
Die Funktion wird erfolgreich abgeschlossen. |
|
Weitere Informationen finden Sie unter Fehlercodes. |
| 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.
- Sie können die Benutzeroberflächeneinstellungen mithilfe der Funktionen MsiSetInternalUI, MsiSetExternalUI oder MsiSetExternalUIRecord ändern.
- Sie können den Protokollmodus mithilfe der MsiEnableLog-Funktion festlegen.
- Sie können ein Produkt vollständig entfernen, indem Sie REMOVE=ALL in szCommandLine festlegen.
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 |