Función MsiGetMode (msiquery.h)

  • Artículo

La función MsiGetMode se usa para determinar si el instalador se está ejecutando actualmente en un modo especificado, como se muestra en la tabla. La función devuelve un valor booleano de TRUE o FALSE, que indica si la propiedad específica pasada a la función está establecida actualmente (TRUE) o no establecida (FALSE).

Sintaxis

BOOL MsiGetMode(
  [in] MSIHANDLE  hInstall,
  [in] MSIRUNMODE eRunMode
);

Parámetros

[in] hInstall

Identificador de la instalación proporcionada a una acción personalizada de DLL o obtenida a través de MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct.

[in] eRunMode

Especifica el modo de ejecución. Este parámetro debe tener uno de los valores siguientes.

Valor Significado
MSIRUNMODE_ADMIN
 El modo administrativo se está instalando o el producto se está instalando.
MSIRUNMODE_ADVERTISE
 Los anuncios se instalan o el producto está instalando o actualizando.
MSIRUNMODE_MAINTENANCE
 Se está modificando una instalación existente o hay una nueva instalación.
MSIRUNMODE_ROLLBACKENABLED
 La reversión está habilitada.
MSIRUNMODE_LOGENABLED
 El archivo de registro está activo. Se ha habilitado antes de la sesión de instalación.
MSIRUNMODE_OPERATIONS
 Las operaciones de ejecución se encuentran en la fase de determinación.
MSIRUNMODE_REBOOTATEND
 Un reinicio es necesario después de una instalación correcta (settable).
MSIRUNMODE_REBOOTNOW
 Es necesario reiniciar para continuar la instalación (settable).
MSIRUNMODE_CABINET
 Los archivos de los gabinetes y los archivos de tabla multimedia se instalan.
MSIRUNMODE_SOURCESHORTNAMES
 LongFileNames de origen se suprime a través de la propiedad de resumen PID_MSISOURCE.
MSIRUNMODE_TARGETSHORTNAMES
 LongFileNames de destino se suprime a través de la propiedad SHORTFILENAMES .
MSIRUNMODE_RESERVED11
 Reservado para uso futuro.
MSIRUNMODE_WINDOWS9X
 El sistema operativo es una versión 9x.
MSIRUNMODE_ZAWENABLED
 El sistema operativo admite la instalación de la demanda.
MSIRUNMODE_RESERVED14
 Reservado para uso futuro.
MSIRUNMODE_RESERVED15
 Reservado para uso futuro.
MSIRUNMODE_SCHEDULED
 Una acción personalizada llamada desde la ejecución del script de instalación.
MSIRUNMODE_ROLLBACK
 Una acción personalizada llamada desde el script de ejecución de reversión.
MSIRUNMODE_COMMIT
 Una acción personalizada llamada desde el script de ejecución de confirmación.

Valor devuelto

TRUE indica que la propiedad específica que se pasa a la función está establecida actualmente.

FALSE indica que la propiedad específica que se pasa a la función no está establecida actualmente.

Comentarios

Tenga en cuenta que no todos los valores del modo de ejecución de iRunMode están disponibles al llamar a MsiGetMode desde una acción personalizada diferida. Para obtener más información, consulte Obtención de información de contexto para acciones personalizadas de ejecución diferida.

Requisitos

   
Cliente mínimo compatible Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP
Plataforma de destino Windows
Encabezado msiquery.h
Library Msi.lib
Archivo DLL Msi.dll

Consulte también

Funciones de acceso de estado del instalador