Compartir a través de

Función MsiProcessAdvertiseScriptW (msi.h)

  • Artículo

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

Sintaxis

UINT MsiProcessAdvertiseScriptW(
  [in] LPCWSTR szScriptFile,
  [in] LPCWSTR 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 archivo de icono o transformación.

[in] hRegData

Una clave del Registro en 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 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.

[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 crearse.

Valor devuelto

Valor Significado
ERROR_SUCCESS
 Si se devuelve este valor, significa que la función se completó correctamente.
ERROR_ACCESS_DENIED
 El proceso de llamada no se estaba ejecutando en la cuenta LocalSystem.
Un 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.
 
 

Comentarios

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 Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible 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 para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
Plataforma de destino Windows
Encabezado msi.h
Library Msi.lib
Archivo DLL Msi.dll