Función MsiProcessAdvertiseScriptA (msi.h)

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 escriben archivos de transformación ni icono.

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

[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.
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 en 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
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