Compartir a través de


Función MsiGetMode (msiquery.h)

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