MsiGetMode-Funktion (msiquery.h)

  • Artikel

Die MsiGetMode-Funktion wird verwendet, um zu bestimmen, ob das Installationsprogramm derzeit in einem angegebenen Modus ausgeführt wird, wie in der Tabelle aufgeführt. Die Funktion gibt einen booleschen Wert von TRUE oder FALSE zurück, der angibt, ob die an die Funktion übergebene spezifische Eigenschaft derzeit festgelegt (TRUE) oder nicht festgelegt (FALSE) ist.

Syntax

BOOL MsiGetMode(
  [in] MSIHANDLE  hInstall,
  [in] MSIRUNMODE eRunMode
);

Parameter

[in] hInstall

Behandeln Sie die Installation, die für eine benutzerdefinierte DLL-Aktion bereitgestellt oder über MsiOpenPackage, MsiOpenPackageEx oder MsiOpenProduct abgerufen wird.

[in] eRunMode

Gibt den Ausführungsmodus an. Dieser Parameter muss über einen der folgenden Werte verfügen.

Wert Bedeutung
MSIRUNMODE_ADMIN
 Der Verwaltungsmodus wird installiert, oder das Produkt wird installiert.
MSIRUNMODE_ADVERTISE
 Die Ankündigungen werden installiert oder das Produkt installiert oder aktualisiert.
MSIRUNMODE_MAINTENANCE
 Eine vorhandene Installation wird geändert oder es gibt eine neue Installation.
MSIRUNMODE_ROLLBACKENABLED
 Rollback ist aktiviert.
MSIRUNMODE_LOGENABLED
 Die Protokolldatei ist aktiv. Sie wurde vor der Installationssitzung aktiviert.
MSIRUNMODE_OPERATIONS
 Ausführungsvorgänge befinden sich in der Ermittlungsphase.
MSIRUNMODE_REBOOTATEND
 Nach erfolgreicher Installation ist ein Neustart erforderlich (settable).
MSIRUNMODE_REBOOTNOW
 Ein Neustart ist erforderlich, um die Installation fortzusetzen (einstellbar).
MSIRUNMODE_CABINET
 Dateien aus Ablagen und Medientabellendateien werden installiert.
MSIRUNMODE_SOURCESHORTNAMES
 Die Quell-LongFileNames-Eigenschaft wird durch die PID_MSISOURCE summary-Eigenschaft unterdrückt.
MSIRUNMODE_TARGETSHORTNAMES
 Der LongFileNames-Zielwert wird durch die SHORTFILENAMES-Eigenschaft unterdrückt.
MSIRUNMODE_RESERVED11
 Für die zukünftige Verwendung reserviert.
MSIRUNMODE_WINDOWS9X
 Das Betriebssystem ist eine 9x-Version.
MSIRUNMODE_ZAWENABLED
 Das Betriebssystem unterstützt die Bedarfsinstallation.
MSIRUNMODE_RESERVED14
 Für die zukünftige Verwendung reserviert.
MSIRUNMODE_RESERVED15
 Für die zukünftige Verwendung reserviert.
MSIRUNMODE_SCHEDULED
 Eine benutzerdefinierte Aktion, die von der Ausführung des Installationsskripts aufgerufen wird.
MSIRUNMODE_ROLLBACK
 Eine benutzerdefinierte Aktion, die vom Rollbackausführungsskript aufgerufen wird.
MSIRUNMODE_COMMIT
 Eine benutzerdefinierte Aktion, die vom Commitausführungsskript aufgerufen wird.

Rückgabewert

TRUE gibt an, dass die spezifische Eigenschaft, die an die Funktion übergeben wird, derzeit festgelegt ist.

FALSE gibt an, dass die spezifische Eigenschaft, die an die Funktion übergeben wird, derzeit nicht festgelegt ist.

Hinweise

Beachten Sie, dass nicht alle Ausführungsmoduswerte von iRunMode verfügbar sind, wenn MsiGetMode aus einer verzögerten benutzerdefinierten Aktion aufgerufen wird. Ausführliche Informationen finden Sie unter Abrufen von Kontextinformationen für benutzerdefinierte Aktionen für verzögerte Ausführung.

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
Zielplattform Windows
Kopfzeile msiquery.h
Bibliothek Msi.lib
DLL Msi.dll

Weitere Informationen

Installerstatuszugriffsfunktionen