Partager via


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
MSIRUNMODE_ADMIN
Le mode d’administration est en cours d’installation ou le produit est en cours d’installation.
MSIRUNMODE_ADVERTISE
Les publicités sont en cours d’installation ou le produit est en cours d’installation ou de mise à jour.
MSIRUNMODE_MAINTENANCE
Une installation existante est en cours de modification ou il y a une nouvelle installation.
MSIRUNMODE_ROLLBACKENABLED
La restauration est activée.
MSIRUNMODE_LOGENABLED
Le fichier journal est actif. Il était activé avant la session d’installation.
MSIRUNMODE_OPERATIONS
Les opérations d’exécution sont en phase de détermination.
MSIRUNMODE_REBOOTATEND
Un redémarrage est nécessaire après une installation réussie (settable).
MSIRUNMODE_REBOOTNOW
Un redémarrage est nécessaire pour poursuivre l’installation (paramétrable).
MSIRUNMODE_CABINET
Les fichiers des armoires et des fichiers de table multimédia sont installés.
MSIRUNMODE_SOURCESHORTNAMES
La source LongFileNames est supprimée par le biais de la propriété de résumé PID_MSISOURCE.
MSIRUNMODE_TARGETSHORTNAMES
La cible LongFileNames est supprimée via la propriété SHORTFILENAMES .
MSIRUNMODE_RESERVED11
Réservé pour un usage futur.
MSIRUNMODE_WINDOWS9X
Le système d’exploitation est une version 9x.
MSIRUNMODE_ZAWENABLED
Le système d’exploitation prend en charge l’installation à la demande.
MSIRUNMODE_RESERVED14
Réservé pour un usage futur.
MSIRUNMODE_RESERVED15
Réservé pour un usage futur.
MSIRUNMODE_SCHEDULED
Action personnalisée appelée à partir de l’exécution du script d’installation.
MSIRUNMODE_ROLLBACK
Action personnalisée appelée à partir du script d’exécution de restauration.
MSIRUNMODE_COMMIT
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

Voir aussi

Fonctions d’accès à l’état du programme d’installation