Função MsiAdvertiseProductA (msi.h)

Artigo
11/20/2024

A função MsiAdvertiseProduct gera um script de anúncio ou anuncia um produto para o computador. A função MsiAdvertiseProduct permite que o instalador escreva em um script o registro e as informações de atalho usadas para atribuir ou publicar um produto. O script pode ser escrito para ser consistente com uma plataforma especificada usando MsiAdvertiseProductEx.

Sintaxe

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

Parâmetros

[in] szPackagePath

O caminho completo para o pacote do produto que está sendo anunciado.

[in] szScriptfilePath

O caminho completo para o arquivo de script que será criado com as informações de anúncio. Para anunciar o produto localmente no computador, defina ADVERTISEFLAGS_MACHINEASSIGN ou ADVERTISEFLAGS_USERASSIGN.

Bandeira	Significado
ADVERTISEFLAGS_MACHINEASSIGN 0	Definido para anunciar uma instalação por computador do produto disponível para todos os usuários.
ADVERTISEFLAGS_USERASSIGN 1	Defina para anunciar uma instalação por usuário do produto disponível para um usuário específico.

[in] szTransforms

Uma lista delimitada por ponto-e-vírgula de transformações a serem aplicadas. A lista de transformações pode ser prefixada com o @ ou | caractere para especificar o cache seguro de transformações. O prefixo @ especifica transformações seguras no código-fonte e o | o prefixo indica transformações de caminho completo seguras. Para obter mais informações, consulte transformações protegidas. Esse parâmetro pode ser nulo.

[in] lgidLanguage

O idioma de instalação a ser usado se a origem der suporte a vários idiomas.

Valor de retorno

Valor	Significado
ERROR_SUCCESS	A função foi concluída com êxito.
Um erro relacionado a uma ação	Consulte códigos de erro.
de erro de inicialização	Ocorreu um erro de inicialização.
ERROR_CALL_NOT_IMPLEMENTED	Esse erro será retornado se for feita uma tentativa de gerar um script de anúncio em qualquer plataforma que não seja o Windows 2000 ou o Windows XP. O anúncio para o computador local tem suporte em todas as plataformas.

Observações

Nota

O cabeçalho msi.h define MsiAdvertiseProduct como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
da Plataforma de Destino	Windows
cabeçalho	msi.h
biblioteca	Msi.lib
de DLL	Msi.dll

Consulte também

instalações Multiple-Package

Compartilhar via