Tipo de acción personalizada 22

  • Artículo

Esta acción personalizada se escribe en VBScript. Consulte también Scripts.

Source

El script se instala con la aplicación durante la sesión actual. El campo Source de la tabla CustomAction contiene una clave para la tabla File. 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 quitarlo.

Valor de Type

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 32 bits.

Constantes Hexadecimal Decimal
msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile 0x016 22

 

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
msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001016 4118

 

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.

Comentarios

Las acciones personalizadas escritas en JScript o VBScript requieren el objeto Session de instalación. Tiene el tipo de objeto Session y el instalador lo adjunta 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.

Las acciones personalizadas que hacen referencia a un archivo instalado como origen, como el tipo de acción personalizada 22 (VBScript), deben cumplir estas 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 buscar el archivo de origen que contiene el VBScript.
  • 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.
  • 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.

Custom_Actions