Função MsiAdvertiseProductExA (msi.h)

  • Artigo

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 o registro e as informações de atalho usadas para atribuir ou publicar um produto. O script pode ser gravado 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 para o computador, defina ADVERTISEFLAGS_MACHINEASSIGN ou ADVERTISEFLAGS_USERASSIGN.

Sinalizador Significado
ADVERTISEFLAGS_MACHINEASSIGN
0
 Defina como anunciar uma instalação por computador do produto disponível para todos os usuários.
ADVERTISEFLAGS_USERASSIGN
1
 Defina como 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 de origem e | 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á o script para a plataforma especificada.

Sinalizador 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 de anúncio adicionais. 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 posterior.

Sinalizador Significado
MSIADVERTISEOPTIONS_INSTANCE
1
 Várias instâncias por meio do sinalizador de suporte de transformação de 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 de 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 retornado

Valor Significado
ERROR_SUCCESS
 A função é concluída com êxito.
Um erro relacionado a uma ação
 Para obter mais informações, veja os Códigos de Erro.
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 diferente do Windows 2000 ou do Windows XP. Há suporte para anúncio para o computador local em todas as plataformas.

Comentários

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

Observação

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. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
Plataforma de Destino Windows
Cabeçalho msi.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Instalações de vários pacotes

Sem suporte no Windows Installer 2.0 e nas versões anteriores