MsiEvaluateConditionA-Funktion (msiquery.h)

Artikel
11/20/2024

Die MsiEvaluateCondition-Funktion wertet einen bedingten Ausdruck aus, der Eigenschaftsnamen und -werte enthält.

Syntax

MSICONDITION MsiEvaluateConditionA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szCondition
);

Parameter

[in] hInstall

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

[in] szCondition

Gibt den bedingten Ausdruck an. Dieser Parameter darf nicht NULL-sein. Informationen zur Syntax von bedingten Ausdrücken finden Sie unter Syntax der bedingten Anweisung.

Rückgabewert

Diese Funktion gibt MSICONDITION zurück.

Bemerkungen

In der folgenden Tabelle sind die Von der MsiEvaluateCondition-Funktion verwendeten Werte für Feature- und Komponentenstatus aufgeführt. Diese Zustände werden erst festgelegt, wenn MsiSetInstallLevel aufgerufen wird, entweder direkt oder durch die CostFinalize-Aktion. Daher ist die Zustandsüberprüfung in der Regel nur für bedingte Ausdrücke in einer Aktionssequenztabelle nützlich.

Wert	Bedeutung
INSTALLSTATE_ABSENT	Feature oder Komponente nicht vorhanden.
INSTALLSTATE_LOCAL	Feature oder Komponente auf dem lokalen Computer.
INSTALLSTATE_SOURCE	Feature oder Komponente werden aus der Quelle ausgeführt.
(Nullwert)	Für Features oder Komponenten sind keine Aktionen auszuführen.

Anmerkung

Der msiquery.h-Header definiert MsiEvaluateCondition 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 Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte 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-	Fenster
Header-	msiquery.h
Library	Msi.lib
DLL-	Msi.dll

Siehe auch

-Installationsprogrammaktionsfunktionen

Übergeben von Null als Argument von Windows Installer-Funktionen

Freigeben über