Methode Installer::AdvertiseProduct

Artikel
06/12/2023

Die Methode AdvertiseScript des Installer-Objekts kündigt ein Installationspaket an.

Syntax

.AdvertiseProduct(
  packagePath,
  context,
  transforms,
  language,
  options
)

Parameter

packagePath

Der vollständige Pfad des Windows Installer-Pakets (MSI-Datei) muss angekündigt werden.

context

Der Kontext der Ankündigung. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
msiAdvertiseProductMachine 0	Kündigt die Anwendung für die Installation im Installationskontext pro Computer an. Dadurch steht das Paket allen Benutzern des Computers für die Installation zur Verfügung.
msiAdvertiseProductUser 1	Kündigt die Anwendung für die Installation im Installationskontext pro Benutzer an.

transforms

Die Liste der Transformationen, die auf das Produkt angewendet werden sollen. Transformationen in der Liste sind durch Semikolons getrennt. Dieser Parameter ist optional.

language

Die Sprache des zu verwendenden Installationspakets. Dieser Parameter ist optional.

options

Die Ankündigungsoptionen. Dieser Parameter ist optional. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
msiAdvertiseDefault 0	Standardankündigung
msiAdvertiseSingleInstance 1	Kündigt eine neue Instanz des Produkts an. Erfordert, dass die erste Transformation in der Transformationsliste des transforms-Parameters die Instanztransformation ist, die den Produktcode ändert. Weitere Informationen finden Sie unter Installieren mehrerer Instanzen von Produkten und Patches.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Bemerkungen

Die Methode AdvertiseProduct verwendet die Funktion MsiAdvertiseProductEx.

Beispiele

Das folgende Beispiel zeigt die Verwendung der Methode AdvertiseScript.

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

'
' Perform machine advertisement of package, use transform
'

Installer.AdvertiseProduct "c:\scratch\simpletst\rtm\simple.msi", 0, "c:\scratch\simpletst\rtm\transform.mst"

'
' Verify advertised product state and registration
'
 
MsgBox Installer.ProductState("{BAE98781-CF88-4309-8E2D-3D8B347F5B53}")
MsgBox Installer.ProductInfo("{BAE98781-CF88-4309-8E2D-3D8B347F5B53}", "Transforms")

'
' Remove Product
'
Installer.InstallProduct "c:\scratch\simpletst\rtm\simple.msi", "REMOVE=ALL"

Anforderungen

Anforderung	Wert
Version	Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer 4.5 unter Windows Server 2003 und Windows XP
DLL	Msi.dll
IID	IID_IInstaller ist definiert als 000C1090-0000-0000-C000-000000000046

Siehe auch

Installer
Von Windows Installer 3.1 und früheren Versionen nicht unterstützt

Freigeben über