Installer::AdvertiseScript メソッド

Installer オブジェクトの AdvertiseScript メソッドは、インストール パッケージをアドバタイズします。

構文

.AdvertiseScript(
  scriptPath,
  scriptFlags,
  removeItems
)

パラメーター

scriptPath

CreateAdvertiseScript メソッドによって生成されたスクリプト ファイルへの完全なパス。

scriptFlags

アドバタイズを制御するフラグ。 このパラメーターは、次の値と組み合わせて使用できます。

説明
msiAdvertiseScriptCacheInfo
0x001
アイコンを作成または削除する必要がある場合は、このフラグを含めます。
msiAdvertiseScriptShortcuts
0x004
ショートカットを作成または削除する必要がある場合は、このフラグを含めます。
msiAdvertiseScriptMachineAssign
0x008
製品をコンピューターに割り当てる場合は、このフラグを含めます。
msiAdvertiseScriptConfigurationRegistration
0x020
レジストリ データ内の構成情報と管理情報を書き込むか削除する必要がある場合は、このフラグを含めます。
msiAdvertiseScriptValidateTransformList
0x040
スクリプトで指定されている変換を、この製品に対して以前に登録されていた変換と対比して強制的に検証するには、このフラグを含めます。 変換の競合は、大文字と小文字を区別しない文字列比較を使って検出され、すべてのインストール コンテキストについてユーザーごととマシンごとのインストールの間で評価されることに注意してください。
msiAdvertiseScriptClassInfoRegistration
0x080
COM クラスに関連するレジストリ内のアドバタイズ情報を書き込むか削除する必要がある場合は、このフラグを含めます。
msiAdvertiseScriptExtensionInfoRegistration
0x100
拡張機能に関連するレジストリ内のアドバタイズ情報を書き込むか削除する必要がある場合は、このフラグを含めます。
msiAdvertiseScriptAppInfo
0x180
レジストリ内のアドバタイズ情報を書き込むか削除する必要がある場合は、このフラグを含めます。
msiAdvertiseScriptRegData
0x1A0
レジストリ内のアドバタイズ情報を書き込むか削除する必要がある場合は、このフラグを含めます。

 

removeItems

指定した項目を作成するのではなく削除する場合は TRUE。

戻り値

このメソッドは値を返しません。

解説

AdvertiseScript メソッドは、MsiAdvertiseScript 関数を使います。 AdvertiseScript メソッドを使うには、スクリプトをローカル システム プロセス内で実行する必要があります。

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

必要条件

要件
バージョン
Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 および Windows XP の Windows インストーラー 4.5
[DLL]
Msi.dll
IID
IID_IInstaller が 000C1090-0000-0000-C000-000000000046 として定義されている

こちらもご覧ください

Installer

Windows インストーラー 3.1 以前のバージョンではサポートされていません