MsiSequenceA, fonction (msiquery.h)

La fonction MsiSequence exécute une autre séquence d’actions, comme décrit dans la table spécifiée.

Syntaxe

UINT MsiSequenceA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szTable,
  [in] INT       iSequenceMode
);

Paramètres

[in] hInstall

Gérez l’installation fournie à une action personnalisée DLL ou obtenue via MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.

[in] szTable

Spécifie le nom de la table contenant la séquence d’actions.

[in] iSequenceMode

Ce paramètre n’est actuellement pas implémenté. Il est réservé pour une utilisation ultérieure et doit être 0.

Valeur retournée

Cette fonction retourne UINT.

Remarques

La fonction MsiSequence interroge la table spécifiée, en triant les actions par nombres dans la colonne Sequence. Pour chaque ligne récupérée, une action est exécutée, à condition que toute expression de condition fournie ne soit pas évaluée à FALSE.

Une séquence d’actions contenant des actions qui mettent à jour le système, telles que les actions InstallFiles et WriteRegistryValues , ne peut pas être exécutée en appelant MsiSequence. L’exception à cette règle est si MsiSequence est appelé à partir d’une action personnalisée planifiée dans la table InstallExecuteSequence entre les actions InstallInitialize et InstallFinalize. Les actions qui ne mettent pas à jour le système, telles que AppSearch ou CostInitialize, peuvent être appelées.

Notes

L’en-tête msiquery.h définit MsiSequence en tant qu’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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal 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
En-tête	msiquery.h
Bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

Fonctions d’action du programme d’installation