MsiDoActionA-Funktion (msiquery.h)
Die MsiDoAction--Funktion führt eine integrierte Aktion, eine benutzerdefinierte Aktion oder eine Benutzeroberfläche-Assistentaktion aus.
Syntax
UINT MsiDoActionA(
[in] MSIHANDLE hInstall,
[in] LPCSTR szAction
);
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] szAction
Gibt die auszuführende Aktion an.
Rückgabewert
Diese Funktion gibt UINT zurück.
Bemerkungen
Die MsiDoAction--Funktion führt die Aktion aus, die dem angegebenen Namen entspricht. Wenn der Name vom Installationsprogramm nicht als integrierte Aktion oder als benutzerdefinierte Aktion in der CustomAction-Tabelleerkannt wird, wird der Name an das Handlerobjekt der Benutzeroberfläche übergeben, das eine Funktion oder ein Dialogfeld aufrufen kann. Wenn ein NULL-Aktionsname angegeben wird, verwendet das Installationsprogramm den Groß-/Kleinschreibungswert der ACTION--Eigenschaft als auszuführende Aktion. Wenn kein Eigenschaftswert definiert ist, wird die Standardaktion ausgeführt, die als "INSTALL" definiert ist.
Aktionen, die das System aktualisieren, z. B. die InstallFiles und WriteRegistryValues Aktionen, können nicht durch Aufrufen MsiDoAction-ausgeführt werden. Die Ausnahme dieser Regel ist, wenn MsiDoAction- aus einer benutzerdefinierten Aktion aufgerufen wird, die in der InstallExecuteSequence-Tabelle zwischen der InstallInitialize- und InstallFinalize-Aktionen. Aktionen, die das System nicht aktualisieren, z. B. AppSearch- oder CostInitialize-, können aufgerufen werden.
Anmerkung
Der msiquery.h-Header definiert MsiDoAction 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 |