MsiGetMode, fonction (msiquery.h)

  • Article

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