MsiGetMode-Funktion (msiquery.h)
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 |
|---|---|
|
Der Verwaltungsmodus wird installiert, oder das Produkt wird installiert. |
|
Die Ankündigungen werden installiert oder das Produkt installiert oder aktualisiert. |
|
Eine vorhandene Installation wird geändert oder es gibt eine neue Installation. |
|
Rollback ist aktiviert. |
|
Die Protokolldatei ist aktiv. Sie wurde vor der Installationssitzung aktiviert. |
|
Ausführungsvorgänge befinden sich in der Ermittlungsphase. |
|
Nach erfolgreicher Installation ist ein Neustart erforderlich (settable). |
|
Ein Neustart ist erforderlich, um die Installation fortzusetzen (einstellbar). |
|
Dateien aus Ablagen und Medientabellendateien werden installiert. |
|
Die Quell-LongFileNames-Eigenschaft wird durch die PID_MSISOURCE summary-Eigenschaft unterdrückt. |
|
Der LongFileNames-Zielwert wird durch die SHORTFILENAMES-Eigenschaft unterdrückt. |
|
Für die zukünftige Verwendung reserviert. |
|
Das Betriebssystem ist eine 9x-Version. |
|
Das Betriebssystem unterstützt die Bedarfsinstallation. |
|
Für die zukünftige Verwendung reserviert. |
|
Für die zukünftige Verwendung reserviert. |
|
Eine benutzerdefinierte Aktion, die von der Ausführung des Installationsskripts aufgerufen wird. |
|
Eine benutzerdefinierte Aktion, die vom Rollbackausführungsskript aufgerufen wird. |
|
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 |