Freigeben über


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.
Für jede Installation ist eine Installationsebene definiert. Dabei handelt es sich um einen integralen Wert von 1 bis 32.767. Der Anfangswert wird durch die INSTALLLEVEL-Eigenschaft bestimmt, die in der Eigenschaftentabelle festgelegt wird.

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

Weitere Informationen

Installerauswahlfunktionen