Função MsiAdvertiseProductA (msi.h)

  • Artigo

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 gravado 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 para o computador, defina ADVERTISEFLAGS_MACHINEASSIGN ou ADVERTISEFLAGS_USERASSIGN.

Sinalizador 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 de origem 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 retornado

Valor Significado
ERROR_SUCCESS
 A função foi concluída com êxito.
Um erro relacionado a uma ação
 Consulte 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. O anúncio para o computador local tem suporte em todas as plataformas.

Comentários

Observação

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

   
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