MsiGetMode, fonction (msiquery.h)
La fonction MsiGetMode est utilisée pour déterminer si le programme d’installation s’exécute actuellement dans un mode spécifié, comme indiqué dans le tableau. La fonction retourne une valeur booléenne true ou FALSE, indiquant si la propriété spécifique passée à la fonction est actuellement définie (TRUE) ou non définie (FALSE).
Syntaxe
BOOL MsiGetMode(
[in] MSIHANDLE hInstall,
[in] MSIRUNMODE eRunMode
);
Paramètres
[in] hInstall
Gérez l’installation fournie à une action personnalisée DLL ou obtenue via MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.
[in] eRunMode
Spécifie le mode d’exécution. Ce paramètre doit avoir l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Le mode d’administration est en cours d’installation ou le produit est en cours d’installation. |
|
Les publicités sont en cours d’installation ou le produit est en cours d’installation ou de mise à jour. |
|
Une installation existante est en cours de modification ou il y a une nouvelle installation. |
|
La restauration est activée. |
|
Le fichier journal est actif. Il était activé avant la session d’installation. |
|
Les opérations d’exécution sont en phase de détermination. |
|
Un redémarrage est nécessaire après une installation réussie (settable). |
|
Un redémarrage est nécessaire pour poursuivre l’installation (paramétrable). |
|
Les fichiers des armoires et des fichiers de table multimédia sont installés. |
|
La source LongFileNames est supprimée par le biais de la propriété de résumé PID_MSISOURCE. |
|
La cible LongFileNames est supprimée via la propriété SHORTFILENAMES . |
|
Réservé pour un usage futur. |
|
Le système d’exploitation est une version 9x. |
|
Le système d’exploitation prend en charge l’installation à la demande. |
|
Réservé pour un usage futur. |
|
Réservé pour un usage futur. |
|
Action personnalisée appelée à partir de l’exécution du script d’installation. |
|
Action personnalisée appelée à partir du script d’exécution de restauration. |
|
Action personnalisée appelée à partir du script d’exécution de validation. |
Valeur retournée
TRUE indique que la propriété spécifique passée à la fonction est actuellement définie.
FALSE indique que la propriété spécifique passée à la fonction n’est actuellement pas définie.
Notes
Notez que toutes les valeurs de mode d’exécution d’iRunMode ne sont pas disponibles lors de l’appel de MsiGetMode à partir d’une action personnalisée différée. Pour plus d’informations, consultez Obtention d’informations de contexte pour les actions personnalisées d’exécution différée.
Spécifications
| 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 |