Función MsiAdvertiseProductA (msi.h)

La función MsiAdvertiseProduct genera un script de anuncio o anuncia un producto en el equipo. La función msiAdvertiseProduct permite al instalador escribir en un script la información del registro y el acceso directo que se usa para asignar o publicar un producto. El script se puede escribir para que sea coherente con una plataforma especificada mediante MsiAdvertiseProductEx.

Sintaxis

UINT MsiAdvertiseProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage
);

Parámetros

[in] szPackagePath

Ruta de acceso completa al paquete del producto que se anuncia.

[in] szScriptfilePath

Ruta de acceso completa al archivo de script que se creará con la información de anuncio. Para anunciar el producto localmente en el equipo, establezca ADVERTISEFLAGS_MACHINEASSIGN o ADVERTISEFLAGS_USERASSIGN.

Bandera	Significado
ADVERTISEFLAGS_MACHINEASSIGN 0	Establézcalo para anunciar una instalación por máquina del producto disponible para todos los usuarios.
ADVERTISEFLAGS_USERASSIGN 1	Establézcalo para anunciar una instalación por usuario del producto disponible para un usuario determinado.

[in] szTransforms

Una lista delimitada por punto y coma de transformaciones que se van a aplicar. La lista de transformaciones se puede prefijar con @ o | carácter para especificar el almacenamiento en caché seguro de las transformaciones. El prefijo @ especifica transformaciones seguras en el origen y | prefijo indica transformaciones de ruta de acceso completa seguras. Para obtener más información, consulte Transformaciones protegidas. Este parámetro puede ser null.

[in] lgidLanguage

Idioma de instalación que se va a usar si el origen admite varios idiomas.

Valor devuelto

Valor	Significado
ERROR_SUCCESS	La función se completó correctamente.
Error relacionado con una acción	Consulte códigos de error.
error de inicialización	Error de inicialización.
ERROR_CALL_NOT_IMPLEMENTED	Este error se devuelve si se intenta generar un script de anuncio en cualquier plataforma distinta de Windows 2000 o Windows XP. El anuncio en el equipo local es compatible con todas las plataformas.

Observaciones

Nota

El encabezado msi.h define MsiAdvertiseProduct 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

instalaciones de Multiple-Package