MsiSetInstallLevel-Funktion (msiquery.h)
Die MsiSetInstallLevel-Funktion legt die Installationsebene für eine vollständige Produktinstallation fest.
Syntax
UINT MsiSetInstallLevel(
[in] MSIHANDLE hInstall,
[in] int iInstallLevel
);
Parameter
[in] hInstall
Behandeln Sie die Installation, die für eine benutzerdefinierte DLL-Aktion bereitgestellt oder mithilfe von MsiOpenPackage, MsiOpenPackageEx oder MsiOpenProduct abgerufen wird.
[in] iInstallLevel
Die Installationsebene.
Rückgabewert
Die MsiSetInstallLevel-Funktion gibt einen der folgenden Werte zurück:
Hinweise
Die MsiSetInstallLevel-Funktion legt Folgendes fest:
- Die Installationsebene für die aktuelle Installation auf einen angegebenen Wert.
- Die Status Select and Installed für alle Features in der Featuretabelle.
- Der Aktionsstatus jeder Komponente in der Tabelle Component, basierend auf der neuen Ebene.
Wenn 0 (null) oder eine negative Zahl im iInstallLevel-Parameter übergeben wird, ändert sich die aktuelle Installationsebene nicht, aber alle Features werden weiterhin basierend auf der aktuellen Installationsebene aktualisiert. Weitere Informationen finden Sie unter Aufrufen von Datenbankfunktionen aus Programmen.
Wenn die Funktion fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe von MsiGetLastErrorRecord abrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |
| Zielplattform | Windows |
| Kopfzeile | msiquery.h |
| Bibliothek | Msi.lib |
| DLL | Msi.dll |