MsiEvaluateConditionA-Funktion (msiquery.h)

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 oder über MsiOpenPackage, MsiOpenPackageEx oder MsiOpenProduct abgerufen wird.

[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.

Hinweise

Die folgende Tabelle zeigt die Von der MsiEvaluateCondition-Funktion verwendeten Feature- und Komponentenzustandswerte. 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	Das Feature oder die Komponente wird von der Quelle ausgeführt.
(NULL-Wert)	Es muss keine Aktion für Feature oder Komponente ausgeführt werden.

 

 

Hinweis

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

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

Installationsaktionsfunktionen

Übergeben von NULL als Argument von Windows Installer Functions