Compartir a través de

Función MsiProcessAdvertiseScriptA (msi.h)

  • Artículo

La función MsiProcessAdvertiseScript procesa un archivo de script de anuncio en las ubicaciones especificadas.

Sintaxis

UINT MsiProcessAdvertiseScriptA(
  [in] LPCSTR szScriptFile,
  [in] LPCSTR szIconFolder,
  [in] HKEY   hRegData,
  [in] BOOL   fShortcuts,
  [in] BOOL   fRemoveItems
);

Parámetros

[in] szScriptFile

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

[in] szIconFolder

Ruta de acceso opcional a una carpeta en la que se encuentran los archivos de icono anunciados y los archivos de transformación. Si este parámetro es null, no se escribe ningún icono o archivo de transformación.

[in] hRegData

Clave del Registro con la que se van a escribir los datos del Registro. Si este parámetro es NULL, el instalador escribe los datos del Registro en la clave adecuada, en función de si el anuncio es por usuario o por máquina. Si este parámetro no esNULL, 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.

[in] fShortcuts

TRUE si se deben crear accesos directos. Si SHGetSpecialFolderLocation devuelve una carpeta especial, contendrá los accesos directos.

[in] fRemoveItems

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

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 no está disponible para esta plataforma.
 
 

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 MsiProcessAdvertiseScript 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