Função MsiAdvertiseProductA (msi.h)
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.
[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 |
|---|---|
|
A função foi concluída com êxito. |
|
Consulte Códigos de erro. |
| Ocorreu um erro de inicialização. | |
|
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 |