Función MsiAdvertiseScriptA (msi.h)

Artículo
11/20/2024

La función MsiAdvertiseScript copia un archivo de script anunciado en las ubicaciones especificadas.

Sintaxis

UINT MsiAdvertiseScriptA(
  [in] LPCSTR szScriptFile,
  [in] DWORD  dwFlags,
  [in] PHKEY  phRegData,
  [in] BOOL   fRemoveItems
);

Parámetros

[in] szScriptFile

Ruta de acceso completa a un archivo de script generado por MsiAdvertiseProduct o MsiAdvertiseProductEx.

[in] dwFlags

Las marcas de bits siguientes del anuncio de control SCRIPTFLAGS. El valor de dwFlags puede ser una combinación de los valores siguientes.

Bandera	Significado
SCRIPTFLAGS_CACHEINFO 0x001	Incluya esta marca si es necesario crear o quitar los iconos.
SCRIPTFLAGS_SHORTCUTS 0x004	Incluya esta marca si es necesario crear o quitar los accesos directos.
SCRIPTFLAGS_MACHINEASSIGN 0x008	Incluya esta marca si el producto que se va a asignar a un equipo.
SCRIPTFLAGS_REGDATA_CNFGINFO 0x020	Incluya esta marca si es necesario escribir o quitar la información de configuración y administración de los datos del Registro.
SCRIPTFLAGS_VALIDATE_TRANSFORMS_LIST 0x040	Incluya esta marca para forzar la validación de las transformaciones enumeradas en el script en las transformaciones registradas anteriormente para este producto. Tenga en cuenta que los conflictos de transformación se detectan mediante una comparación de cadenas que no distingue mayúsculas de minúsculas y se evalúan entre las instalaciones por usuario y por máquina en todos los contextos. Si la lista de transformaciones del script no coincide con las transformaciones registradas para el producto, la función devuelve ERROR_INSTALL_TRANSFORM_FAILURE.
SCRIPTFLAGS_REGDATA_CLASSINFO 0x080	Incluya esta marca si es necesario escribir o quitar la información del anuncio en el Registro relacionada con las clases COM.
SCRIPTFLAGS_REGDATA_EXTENSIONINFO 0x100	Incluya esta marca si es necesario escribir o quitar la información del anuncio en el Registro relacionada con una extensión.
SCRIPTFLAGS_REGDATA_APPINFO 0x180	Incluya esta marca si es necesario escribir o quitar la información del anuncio en el Registro.
SCRIPTFLAGS_REGDATA 0x1A0	Incluya esta marca si es necesario escribir o quitar la información del anuncio en el Registro.

[in] phRegData

Clave del Registro con la que se va a escribir información temporal sobre los datos del Registro. Si este parámetro es null, los datos del Registro se colocan bajo la clave adecuada, en función de si el anuncio es por usuario o por máquina. Si este parámetro no es NULL, el script escribirá los datos del Registro en la clave del Registro especificada en lugar de en la ubicación normal. En este caso, la aplicación no se anunciará al usuario.

Tenga en cuenta que esta clave del Registro no se puede usar al generar un anuncio de un producto para un usuario o un equipo porque el proveedor de la clave del Registro normalmente elimina la clave. La clave del Registro se encuentra fuera de las ubicaciones normales del Registro para la información de configuración de shell, clase y .msi y no está en HKEY_CLASSES_ROOT. Esta clave del Registro solo está pensada para obtener información temporal sobre los datos del Registro en un script.

[in] fRemoveItems

TRUE si se van a quitar los elementos especificados en lugar de crearse.

Valor devuelto

Valor	Significado
ERROR_SUCCESS	La función se completó correctamente.
ERROR_ACCESS_DENIED	El proceso de llamada no se estaba ejecutando en la cuenta localSystem.
Error relacionado con una acción	Consulte códigos de error.
error de inicialización	Error relacionado con la inicialización.
ERROR_CALL_NOT_IMPLEMENTED	Esta función solo está disponible en Windows 2000 y Windows XP.

Observaciones

El proceso que llama a esta función debe ejecutarse en la cuenta localSystem. Para anunciar una aplicación para la instalación por usuario a un usuario de destino, el subproceso que llama a esta función debe suplantar al usuario de destino. Si el subproceso que llama a esta función no suplanta a un usuario de destino, la aplicación se anuncia a todos los usuarios para su instalación con privilegios elevados.

Nota

El encabezado msi.h define MsiAdvertiseScript como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	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. Consulte Windows Installer Run-Time Requirements (Requisitos de Windows Installer) para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
de la plataforma de destino de	Windows
encabezado de	msi.h
biblioteca de	Msi.lib
DLL de	Msi.dll

Consulte también

contexto de instalación de

Compartir a través de