MsiDoActionA, fonction (msiquery.h)
La fonction MsiDoAction exécute une action intégrée, une action personnalisée ou une action de l’Assistant interface utilisateur.
Syntaxe
UINT MsiDoActionA(
[in] MSIHANDLE hInstall,
[in] LPCSTR szAction
);
Paramètres
[in] hInstall
Gérez l’installation fournie à une action personnalisée DLL ou obtenue via msiOpenPackage, MsiOpenPackageExou MsiOpenProduct.
[in] szAction
Spécifie l’action à exécuter.
Valeur de retour
Cette fonction retourne UINT.
Remarques
La fonction MsiDoAction exécute l’action qui correspond au nom fourni. Si le nom n’est pas reconnu par le programme d’installation en tant qu’action intégrée ou en tant qu’action personnalisée dans la table CustomAction, le nom est passé à l’objet gestionnaire d’interface utilisateur, qui peut appeler une fonction ou une boîte de dialogue. Si un nom d’action Null est fourni, le programme d’installation utilise la valeur majuscule de la propriété ACTION comme action à effectuer. Si aucune valeur de propriété n’est définie, l’action par défaut est effectuée, définie comme « INSTALL ».
Les actions qui mettent à jour le système, telles que l'InstallFiles et WriteRegistryValues actions, ne peuvent pas être exécutées en appelant MsiDoAction. L’exception à cette règle est si msiDoAction est appelée à partir d’une action personnalisée planifiée dans la table InstallExecuteSequence entre l'InstallInitialize et les actions InstallFinalize. Les actions qui ne mettent pas à jour le système, telles que AppSearch ou CostInitialize, peuvent être appelées.
Note
L’en-tête msiquery.h définit MsiDoAction comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP |
| plateforme cible | Windows |
| d’en-tête | msiquery.h |
| bibliothèque | Msi.lib |
| DLL | Msi.dll |