MsiDoActionA-Funktion (msiquery.h)

Die MsiDoAction-Funktion führt eine integrierte Aktion, eine benutzerdefinierte Aktion oder eine Benutzeroberflächen-Assistentenaktion 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 oder über MsiOpenPackage, MsiOpenPackageEx oder MsiOpenProduct abgerufen wird.

[in] szAction

Gibt die auszuführende Aktion an.

Rückgabewert

Diese Funktion gibt UINT zurück.

Hinweise

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-Tabelle erkannt wird, wird der Name an das Benutzeroberflächenhandlerobjekt übergeben, das eine Funktion oder ein Dialogfeld aufrufen kann. Wenn ein Null-Aktionsname angegeben wird, verwendet das Installationsprogramm den Großbuchstabenwert 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 Aktionen InstallFiles und WriteRegistryValues , können nicht durch Aufrufen von MsiDoAction ausgeführt werden. Die Ausnahme von dieser Regel ist, wenn MsiDoAction aus einer benutzerdefinierten Aktion aufgerufen wird, die in der Tabelle InstallExecuteSequence zwischen den Aktionen InstallInitialize und InstallFinalize geplant ist. Aktionen, mit denen das System nicht aktualisiert wird, z. B. AppSearch oder CostInitialize, können aufgerufen werden.

Anforderungen

Weitere Informationen

Installationsaktionsfunktionen