Tipo de acción personalizada 21
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.
Fuente
El script se instala con la aplicación durante la sesión actual. El campo Origen de la tabla CustomAction de contiene una clave para la tabla archivo de . La ubicación del código de acción personalizada viene determinada por la resolución de la ruta de acceso de destino para este archivo; Por lo tanto, se debe llamar a esta acción personalizada después de instalar el archivo y antes de quitarla.
Valor de tipo
Incluya el siguiente valor en la columna Tipo de la tabla CustomAction para especificar el tipo numérico básico de una acción personalizada de 32 bits.
| Constantes | Hexadecimal | Decimal |
|---|---|---|
| msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile | 0x015 | 21 |
Windows Installer puede usar acciones personalizadas de 64 bits en sistemas operativos de 64 bits. Una acción personalizada de 64 bits basada en scripts debe incluir el msidbCustomActionType64BitScript bit en su tipo numérico. Para obtener información, consulte Acciones personalizadas de 64 bits. Incluya el siguiente valor en la columna Tipo de la tabla CustomAction para especificar el tipo numérico básico de una acción personalizada de 64 bits.
| Constantes | Hexadecimal | Decimal |
|---|---|---|
| msidbCustomActionTypeJScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript | 0x0001015 | 4117 |
Blanco
El campo Destino de la tabla CustomAction contiene una función de script opcional. El procesamiento envía primero el script para analizar 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 Tipo de la tabla CustomAction para especificar las opciones de procesamiento de retorno. Para obtener una descripción de las opciones y los valores, vea 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 Tipo 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, vea Opciones de programación de ejecución de acciones personalizadas.
Opciones de ejecución de In-Script
Incluya bits de marca opcionales en la columna Tipo de la tabla CustomAction para especificar una opción 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, vea Acción personalizada In-Script Opciones de ejecución.
Valores devueltos
Las funciones opcionales escritas en 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 objeto Session. El instalador adjunta el Objeto de sesión al script con el nombre "Session". Dado que es posible que el objeto session no exista durante la reversión de la instalación, una acción personalizada diferida escrita en el script debe usar uno de los métodos o propiedades del objeto Session Session descrito en la sección Obtener información de contexto para acciones personalizadas de ejecución diferida para recuperar su contexto.
Las acciones personalizadas que hacen referencia a un archivo instalado como origen, como custom Action Type 21 (JScript), deben cumplir las siguientes restricciones de secuenciación:
- La acción personalizada debe secuenciarse después de la acción CostFinalize. Esto es para que la acción personalizada pueda resolver la ruta de acceso necesaria para localizar el archivo de origen que contiene el JScript.
- Si el archivo de origen aún no está instalado en el equipo, las acciones personalizadas diferidas (en script) de este tipo deben secuenciarse después de la acción InstallFiles de .
- Si el archivo de origen aún no está instalado en el equipo, las acciones personalizadas no diferidas de este tipo deben secuenciarse después de la acción InstallFinalize de .
Temas relacionados