Função MsiAdvertiseProductExA (msi.h)

Artigo
11/20/2024

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

Sintaxe

UINT MsiAdvertiseProductExA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage,
  [in] DWORD  dwPlatform,
  [in] DWORD  dwOptions
);

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 a ser criado com as informações anunciadas. Para anunciar o produto localmente no computador, defina ADVERTISEFLAGS_MACHINEASSIGN ou ADVERTISEFLAGS_USERASSIGN.

Bandeira	Significado
ADVERTISEFLAGS_MACHINEASSIGN 0	Defina 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 caminho completo seguro – transformações. Para obter mais informações, consulte transformações protegidas. Esse parâmetro pode ser nulo.

[in] lgidLanguage

O idioma a ser usado se a origem der suporte a vários idiomas.

[in] dwPlatform

Sinalizadores de bits que controlam para qual plataforma o instalador deve criar o script. Esse parâmetro será ignorado se szScriptfilePath for nulo. Se dwPlatform for zero (0), o script será criado com base na plataforma atual. Essa é a mesma funcionalidade que MsiAdvertiseProduct. Se dwPlatform for 1 ou 2, o instalador criará um script para a plataforma especificada.

Bandeira	Significado
nenhum 0	Cria um script para a plataforma atual.
MSIARCHITECTUREFLAGS_X86 1	Cria um script para a plataforma x86.
MSIARCHITECTUREFLAGS_IA64 2	Cria um script para sistemas baseados em Itanium.
MSIARCHITECTUREFLAGS_AMD64 4	Cria um script para a plataforma x64.

[in] dwOptions

Sinalizadores de bits que especificam opções extras de anúncio. O valor diferente de zero só está disponível nas versões do Windows Installer fornecidas com o Windows Server 2003 e o Windows XP com SP1 e posteriores.

Bandeira	Significado
MSIADVERTISEOPTIONS_INSTANCE 1	Várias instâncias por meio do sinalizador de suporte à transformação de alteração de código do produto. Anuncia uma nova instância do produto. Requer que o parâmetro szTransforms inclua a transformação da instância que altera o código do produto. Para obter mais informações, consulte Instalando várias instâncias de produtos e patches.

Valor de retorno

Valor	Significado
ERROR_SUCCESS	A função é concluída com êxito.
Um erro relacionado a uma ação	Para obter mais informações, 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

Várias instâncias por meio de transformações de alteração de código do produto só estão disponíveis para envio de versões do Windows Installer com Windows Server 2003 e Windows XP com SP1 e posterior.

Nota

O cabeçalho msi.h define MsiAdvertiseProductEx 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

sem suporte no Windows Installer 2.0 e anteriores

Compartilhar via