Compartilhar via


Método Installer::AdvertiseScript

O método AdvertiseScript do objeto Installer anuncia um pacote de instalação.

Sintaxe

.AdvertiseScript(
  scriptPath,
  scriptFlags,
  removeItems
)

Parâmetros

scriptPath

O caminho completo para o arquivo de script gerado pelo método CreateAdvertiseScript.

scriptFlags

Os sinalizadores que controlam o anúncio. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor Significado
msiAdvertiseScriptCacheInfo
0x001
Inclua esse sinalizador se os ícones precisarem ser criados ou removidos.
msiAdvertiseScriptShortcuts
0x004
Inclua esse sinalizador se os atalhos precisarem ser criados ou removidos.
msiAdvertiseScriptMachineAssign
0x008
Inclua esse sinalizador se o produto deve ser atribuído a um computador.
msiAdvertiseScriptConfigurationRegistration
0x020
Inclua esse sinalizador se as informações de configuração e gerenciamento nos dados do Registro precisarem ser gravadas ou removidas.
msiAdvertiseScriptValidateTransformList
0x040
Inclua esse sinalizador para forçar a validação das transformações listadas no script em relação às transformações registradas anteriormente para este produto. Observe que os conflitos de transformação são detectados por meio de uma comparação de cadeia de caracteres que não diferencia maiúsculas de minúsculas e são avaliados entre as instalações por usuário e por computador em todos os contextos de instalação.
msiAdvertiseScriptClassInfoRegistration
0x080
Inclua esse sinalizador se as informações de anúncio no Registro relacionadas às classes COM precisarem ser gravadas ou removidas.
msiAdvertiseScriptExtensionInfoRegistration
0x100
Inclua esse sinalizador se as informações de anúncio no Registro relacionadas a uma extensão precisarem ser gravadas ou removidas.
msiAdvertiseScriptAppInfo
0x180
Inclua esse sinalizador se as informações de anúncio no Registro precisarem ser gravadas ou removidas.
msiAdvertiseScriptRegData
0x1A0
Inclua esse sinalizador se as informações de anúncio no Registro precisarem ser gravadas ou removidas.

 

removeItems

TRUE se os itens especificados devem ser removidos em vez de serem criados.

Valor retornado

Esse método não retorna um valor.

Comentários

O método AdvertiseScript usa a função MsiAdvertiseScript. O uso do método AdvertiseScript exige que o script seja executado em um processo do sistema local.

Exemplos

O exemplo a seguir demonstra o uso do método AdvertiseScript.

Dim installer
Set installer = CreateObject("WindowsInstaller.Installer")

' Advertise Simple package using an advertise script
'   created by CreateAdvertiseScript Method
'
'  Flags 424 indicate msiAdvertiseScriptMachineAssign, msiAdvertiseScriptRegData

Installer.AdvertiseScript "c:\scratch\simpletst\rtm\simple.aas", 424, false

' Verify Simple is installed
MsgBox Installer.ProductState("{BAE98781-CF88-4309-8E2D-3D8B347F5B53}")

'
' Remove Simple using advertise script
'
Installer.AdvertiseScript "c:\scratch\simpletst\rtm\simple.aas", 424, true

' Verify simple is removed
MsgBox Installer.ProductState("{BAE98781-CF88-4309-8E2D-3D8B347F5B53}")

Requisitos

Requisito Valor
Versão
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 4.5 no Windows Server 2003 e no Windows XP
DLL
Msi.dll
IID
O IID_IInstaller é definido como 000C1090-0000-0000-C000-000000000046

Confira também

Instalador

Sem suporte no Windows Installer 3.1 e versões anteriores