Share via

Tipo de acción personalizada 5

  • Artículo

Esta acción personalizada se escribe en JScript, como ECMA 262. Windows Installer no admite JScript 1.0. Para obtener más información, consulte Scripts.

Source

El script se genera a partir de una secuencia binaria temporal. El campo Source de la tabla CustomAction contiene una clave para la tabla Binary. La columna Data de la tabla Binary contiene los datos de la secuencia. Se asigna una secuencia aparte para cada fila.

Los nuevos datos binarios se pueden insertar desde un archivo usando MsiRecordSetStream seguido de MsiViewModify para insertar el registro en la tabla. Cuando se invoca la acción personalizada, los datos de la secuencia se copian en un archivo temporal, que luego se procesa según el tipo de acción personalizada.

Valor de Type

Incluya el siguiente valor en la columna Type de la tabla CustomAction para especificar el tipo numérico básico de acción personalizada de 32 bits.

Constantes Hexadecimal Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeBinaryData 0x05 5

 

Windows Installer puede usar acciones personalizadas de 64 bits en sistemas operativos de 64 bits. Las acciones personalizadas de 64 bits basadas en scripts deben incluir el bit msidbCustomActionType64BitScript en su tipo numérico. Para obtener información, consulte Acciones personalizadas de 64 bits. Incluya el siguiente valor en la columna Type de la tabla CustomAction para especificar el tipo numérico básico de una acción personalizada de 64 bits.

Constantes Hexadecimal Decimal
msidbCustomActionTypeJScript + msidbCustomActionTypeBinaryData + msidbCustomActionType64BitScript 0x0001005 4101

 

Destino

El campo Target de la tabla CustomAction contiene una función de script opcional. El procesamiento envía primero el script para analizarlo y, a continuación, llama a la función de script opcional.

Opciones de procesamiento de devolución

Incluya bits de marca opcionales en la columna Type de la tabla CustomAction para especificar las opciones de procesamiento de devolución. Para ver una descripción de las opciones y los valores, consulte Opciones de procesamiento de devolución de acción personalizada.

Opciones de programación de ejecución

Incluya bits de marca opcionales en la columna Type de la tabla CustomAction para especificar las opciones de programación de ejecución. Estas opciones controlan la ejecución múltiple de acciones personalizadas. Para obtener una descripción de las opciones, consulte Opciones de programación de ejecución de acciones personalizadas.

Opciones de ejecución en script

Incluya bits de marca opcionales en la columna Type de la tabla CustomAction para especificar las opciones de ejecución en script. Estas opciones copian el código de acción en el script de ejecución, reversión o confirmación. Para obtener una descripción de las opciones, consulte Opciones de ejecución de acciones personalizadas en script.

Valores devueltos

Las funciones opcionales escritas en el script deben devolver uno de los valores descritos en Valores devueltos de JScript y acciones personalizadas de VBScript.

Observaciones

Una acción personalizada escrita en JScript o VBScript requiere la instalación del objeto Session. El instalador asocia el objeto Session al script con el nombre Session. Dado que es posible que el objeto Session no exista durante una reversión de la instalación, las acciones personalizadas diferidas escritas en el script deben usar uno de los métodos o propiedades del objeto Session que se describen en la sección Obtención de información de contexto para acciones personalizadas de ejecución diferida para recuperar su contexto.

Cuando se exporta una tabla de base de datos, cada secuencia se escribe como un archivo aparte en la subcarpeta con el nombre de la tabla, usando la clave principal como nombre de archivo (columna Name para la tabla Binary), con la extensión predeterminada ".ibd". El nombre debe usar el formato de nombre de archivo 8.3 si el sistema de archivos o el sistema de control de versiones no admiten nombres de archivo largos. El archivo de almacenamiento persistente reemplaza los datos de la secuencia por el nombre de archivo usado, de modo que los datos se puedan encontrar cuando se importe la tabla.

Custom_Actions