大网数据广告活动
安装更新与部署

Installer::AdvertiseScript method

· 52CE 我爱测

The AdvertiseScript method of the Installer object advertises an installation package.

The AdvertiseScript method of the Installer object advertises an installation package.

Syntax

.AdvertiseScript(
  scriptPath,
  scriptFlags,
  removeItems
)

Parameters

scriptPath

The full path to the script file generated by the CreateAdvertiseScript method.

scriptFlags

The flags that control the advertisement. This parameter can be a combination of the following values.

Value Meaning
msiAdvertiseScriptCacheInfo 0x001 Include this flag if the icons need to be created or removed.
msiAdvertiseScriptShortcuts 0x004 Include this flag if the shortcuts need to be created or removed.
msiAdvertiseScriptMachineAssign 0x008 Include this flag if the product is to be assigned to a computer.
msiAdvertiseScriptConfigurationRegistration 0x020 Include this flag if the configuration and management information in the registry data needs to be written or removed.
msiAdvertiseScriptValidateTransformList 0x040 Include this flag to force the validation of the transforms listed in the script against previously registered transforms for this product. Note that transform conflicts are detected using a string comparison that is case insensitive and are evaluated between per-user and per-machine installations across all installation contexts.
msiAdvertiseScriptClassInfoRegistration 0x080 Include this flag if advertisement information in the registry related to COM classes needs to be written or removed.
msiAdvertiseScriptExtensionInfoRegistration 0x100 Include this flag if advertisement information in the registry related to an extension needs to be written or removed.
msiAdvertiseScriptAppInfo 0x180 Include this flag if the advertisement information in the registry needs to be written or removed.
msiAdvertiseScriptRegData 0x1A0 Include this flag if the advertisement information in the registry needs to be written or removed.

removeItems

TRUE if the specified items are to be removed instead of being created.

Return value

This method does not return a value.

Remarks

The AdvertiseScript method uses the MsiAdvertiseScript function. The use of the AdvertiseScript method requires that the script be running within a local system process.

Examples

The following example demonstrates the use of the AdvertiseScript method.

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}")

Requirements

Requirement Value
Version Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer 4.5 on Windows Server 2003 and Windows XP
DLL Msi.dll
IID IID_IInstaller is defined as 000C1090-0000-0000-C000-000000000046

See also

Installer

Not Supported in Windows Installer 3.1 and earlier versions

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。