MsiSequenceA, fonction (msiquery.h)

Article
11/20/2024

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, MsiOpenPackageExou MsiOpenProduct.

[in] szTable

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

[in] iSequenceMode

Ce paramètre est actuellement non implémenté. Elle est réservée à une utilisation future et doit être 0.

Valeur de retour

Cette fonction retourne UINT.

Remarques

La fonction MsiSequence interroge la table spécifiée, en triant les actions par les nombres de la colonne Séquence. Pour chaque ligne récupérée, une action est exécutée, à condition que toute expression de condition fournie n’ait pas la valeur FALSE.

Une séquence d’actions contenant toutes les actions qui mettent à jour le système, telles que les InstallFiles et WriteRegistryValues actions, ne peut pas être exécutée en appelant MsiSequence. L’exception à cette règle est si msiSequence 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 MsiSequence 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

Voir aussi

Fonctions d’action du programme d’installation

Partager via