Compartir a través de

Referencia de la función del instalador

  • Artículo

Para habilitar Windows Installer en la aplicación, debe usar las funciones del instalador. Las tablas de este tema identifican las funciones por categoría.

Funciones de interfaz de usuario y registro

Nombre Descripción
MsiSetInternalUI Habilita la interfaz de usuario interna del instalador.
MsiSetExternalUI Habilita un controlador de interfaz de usuario externo que recibe mensajes en un formato de cadena.
MsiSetExternalUIRecord Habilita un controlador de interfaz de usuario externo que recibe mensajes en un formato de registro.
MsiEnableLog Establece el modo de registro para todas las instalaciones del proceso de llamada.

 

Funciones de administración del controlador

Nombre Descripción
MsiCloseHandle Cierra un controlador de instalación abierto.
MsiCloseAllHandles Cierra todos los controladores de instalación abiertos. No usar para una limpieza.

 

Funciones de instalación y configuración

Nombre Descripción
MsiAdvertiseProduct Anuncia un producto.
MsiAdvertiseProductEx Anuncia un producto.
MsiAdvertiseScript Copia un archivo de script de anuncio en ubicaciones especificadas.
MsiInstallProduct Instala o quita una aplicación o un conjunto de aplicaciones.
MsiConfigureProduct Instala o quita una aplicación o un conjunto de aplicaciones.
MsiConfigureProductEx Instala o quita una aplicación o un conjunto de aplicaciones. Se puede especificar una línea de comandos de producto.
MsiReinstallProduct Vuelve a instalar o repara una instalación.
MsiConfigureFeature Configura el estado instalado de una característica.
MsiReinstallFeature Valida o repara las características.
MsiInstallMissingComponent Instala los componentes que faltan.
MsiInstallMissingFile Instala los archivos que faltan.
MsiNotifySidChange Notifica y actualiza la información interna de Windows Installer con cambios en los SID de usuario. Disponible a partir de Windows Installer 3.1.
MsiProcessAdvertiseScript Procesa un archivo de script de anuncio en ubicaciones especificadas.
MsiSourceListAddSource Agrega o vuelve a ordenar los orígenes de una revisión o un producto en un contexto especificado.
MsiSourceListAddSourceEx Agrega o vuelve a ordenar los orígenes de una revisión o un producto en un contexto especificado. Crea una lista de origen para una revisión que no existe en un contexto especificado. Disponible en Windows Installer 3.0.
MsiSourceListClearSource Quita un origen existente de un producto o revisión en un contexto especificado. Disponible en Windows Installer 3.0.
MsiSourceListClearAll Quita todos los orígenes existentes de un tipo de origen específico para una instancia de producto especificada.
MsiSourceListClearAllEx Quita todos los orígenes existentes de un tipo de origen específico para una instancia de producto especificada. Disponible en Windows Installer 3.0.
MsiSourceListForceResolution Quita el registro del origen actual del producto o revisión, que está registrado como la propiedad "LastUsedSource". Esta función no afecta a la lista de origen registrada.
MsiSourceListForceResolutionEx Quita el registro del origen actual del producto o revisión, que está registrado como la propiedad "LastUsedSource". Esta función no afecta a la lista de origen registrada. Disponible en Windows Installer 3.0.
MsiSourceListGetInfo Recupera información sobre la lista de origen de un producto o revisión en un contexto específico.
MsiSourceListSetInfo Establece el origen usado más recientemente para un producto o revisión en un contexto especificado. Disponible en Windows Installer 3.0.
MsiSourceListEnumMediaDisks Enumera la lista de discos registrados para el origen multimedia de una revisión o producto. Disponible en Windows Installer 3.0.
MsiSourceListAddMediaDisk Agrega o actualiza un disco del origen multimedia de un producto o revisión registrados. Disponible en Windows Installer 3.0.
MsiSourceListClearMediaDisk Quita un disco registrado existente en el origen multimedia de un producto o revisión en un contexto específico. Disponible en Windows Installer 3.0.
MsiSourceListEnumSources Enumera los orígenes de la lista de origen de una revisión o producto especificados. Disponible en Windows Installer 3.0.

 

Funciones específicas del componente

Nombre Descripción
MsiProvideAssembly Instala y devuelve el trazado completo del componente para un ensamblado.
MsiProvideComponent Instala y devuelve el trazado completo del componente de un componente.
MsiProvideQualifiedComponent Instala y devuelve el trazado completo del componente de un componente cualificado.
MsiProvideQualifiedComponentEx Instala y devuelve el trazado completo del componente de un componente calificado publicado por un producto.
MsiGetComponentPath Devuelve el trazado completo o la clave del Registro a un componente instalado.
MsiGetComponentPathEx Devuelve el trazado completo o la clave del Registro a un componente instalado en las cuentas de usuario y el contexto de instalación. Windows Installer 4.5 y versiones anteriores: No compatible.
MsiLocateComponent Devuelve el trazado completo a un componente instalado sin un código de producto.
MsiQueryComponentState Devuelve el estado instalado a un componente. Puede consultar los componentes de una instancia de un producto instalado en cuentas de usuario distintas del usuario actual. Disponible en Windows Installer 3.0 o posterior.

 

Funciones solo de la aplicación

Nombre Descripción
MsiCollectUserInfo Almacena información de usuario de un asistente para la instalación.
MsiUseFeature Incrementa el recuento de uso de una característica e indica el estado de la instalación.
MsiUseFeatureEx Incrementa el recuento de uso de una característica e indica el estado de la instalación.
MsiGetProductCode Devuelve el código de producto mediante el código de componente.

 

Funciones de estado del sistema

Nombre Descripción
MsiEnumProducts Enumera los productos anunciados.
MsiEnumProductsEx Enumera todas las instancias de productos anunciados o instalados en un contexto especificado. Disponible en Windows Installer 3.0 o posterior.
MsiEnumRelatedProducts Enumera los productos instalados actualmente que tienen un código de actualización especificado.
MsiEnumFeatures Enumera las características publicadas.
MsiEnumComponents Enumera los componentes instalados.
MsiEnumComponentsEx Enumera los componentes instalados en las cuentas de usuario y el contexto de instalación. Windows Installer 4.5 y versiones anteriores: No compatible.
MsiEnumClients Enumera los clientes de un componente instalado.
MsiEnumClientsEx Enumera los clientes de un componente instalado en las cuentas de usuario y el contexto de instalación. Windows Installer 4.5 y versiones anteriores: No compatible.
MsiEnumComponentQualifiers Enumera los calificadores anunciados para un componente.
MsiQueryFeatureState Devuelve el estado instalado de una característica.
MsiQueryFeatureStateEx Devuelve el estado instalado para una característica de producto. Puede consultar las características de una instancia de un producto instalado en cuentas de usuario distintas del usuario actual. Disponible en Windows Installer 3.0 o posterior.
MsiQueryProductState Devuelve el estado instalado para una aplicación o un conjunto de aplicaciones.
MsiGetFeatureUsage Devuelve el uso de métricas para una característica.
MsiGetProductInfo Devuelve información del producto para los productos publicados e instalados.
MsiGetProductInfoEx Devuelve información del producto para los productos anunciados e instalados. Puede recuperar información sobre una instancia de un producto instalado en una cuenta de usuario distinta del usuario actual. Disponible en Windows Installer 3.0 o posterior.
MsiGetUserInfo Devuelve información de usuario registrado para un producto instalado.

 

Funciones de consulta de productos

Nombre Descripción
MsiOpenProduct Abre un producto para usarlo con las funciones que acceden a la base de datos.
MsiOpenPackage Abre un paquete para usarlo con las funciones que acceden a la base de datos.
MsiOpenPackageEx Abre un paquete para usarlo con las funciones que acceden a la base de datos.
MsiIsProductElevated Comprueba si el producto está instalado con privilegios elevados.
MsiGetProductInfoFromScript Devuelve información del producto para un archivo de script del instalador.
MsiGetProductProperty Recupera las propiedades de la base de datos del producto.
MsiGetShortcutTarget Examina un acceso directo y devuelve su producto, nombre de característica y componente si está disponible.
MsiGetFeatureInfo Devuelve información descriptiva de una característica.
MsiVerifyPackage Comprueba que un archivo especificado es un paquete de instalación.

 

Funciones de aplicación de revisiones

Nombre Descripción
MsiApplyPatch Invoca una instalación y aplica un paquete de revisión.
MsiEnumPatches Devuelve el GUID de cada revisión que se aplica a un producto y una lista de transformaciones de cada revisión que se le aplica.
MsiGetPatchInfo Devuelve información sobre una revisión.
MsiRemovePatches Desinstala una revisión de un producto. Disponible en Windows Installer 3.0.
MsiDeterminePatchSequence Determina la mejor secuencia de aplicación para un conjunto de revisiones y productos. Disponible en Windows Installer 3.0.
MsiApplyMultiplePatches Aplica una o varias revisiones a los productos. Disponible en Windows Installer 3.0.
MsiEnumPatchesEx Enumera todas las revisiones aplicadas a un producto en un contexto determinado o en todos los contextos. Disponible en Windows Installer 3.0.
MsiGetPatchFileList Cuando se proporciona una lista de archivos .msp, esta función recupera la lista de archivos que las revisiones pueden actualizar para el destino. Disponible en Windows Installer 4.0.
MsiGetPatchInfoEx Consulta para obtener información sobre la aplicación de una revisión especificada en un producto especificado. Disponible en Windows Installer 3.0.
MsiExtractPatchXMLData Extrae información de una revisión. Disponible en Windows Installer 3.0.
MsiDetermineApplicablePatches Determina el mejor conjunto de revisiones necesarias para actualizar un producto o un conjunto de productos. Disponible en Windows Installer 3.0.

 

Funciones de consulta de archivos

Nombre Descripción
MsiGetFileHash Toma el trazado a un archivo y devuelve un hash de 128 bits de ese archivo.
MsiGetFileSignatureInformation Toma el trazado a un archivo firmado digitalmente y devuelve el certificado y el hash del firmante del archivo.
MsiGetFileVersion Devuelve la cadena de versión y la cadena de idioma.

 

Funciones de administración de transacciones

Nombre Descripción
MsiBeginTransaction Inicia el procesamiento de transacciones de una instalación de varios paquetes y devuelve un identificador para la transacción. Esta función está disponible a partir de Windows Installer 4.5.
MsiJoinTransaction Solicita que Windows Installer convierta el proceso actual en el propietario de la transacción que realiza una instalación de varios paquetes. Esta función está disponible a partir de Windows Installer 4.5.
MsiEndTransaction Confirma o revierte todas las instalaciones que pertenecen a la transacción. Esta función está disponible a partir de Windows Installer 4.5.

 

Funciones de base de datos

Además de las funciones de Windows Installer que se identifican en las tablas anteriores, puede manipular información en la base de datos de instalación mediante las funciones de acceso a la base de datos que se describen en la sección Funciones de base de datos.

Estructuras del instalador

Además, parte de la información de la base de datos de instalación se controla mediante las estructuras descritas en la sección Estructuras del instalador.