MsiAdvertiseProductExA-Funktion (msi.h)

Artikel
11/20/2024

Die MsiAdvertiseProductEx--Funktion generiert ein Werbeskript oder kündigt ein Produkt auf dem Computer an. Mit dieser Funktion kann Windows Installer in ein Skript schreiben, mit dem die Registrierungs- und Verknüpfungsinformationen zum Zuweisen oder Veröffentlichen eines Produkts verwendet werden. Das Skript kann so geschrieben werden, dass es mit einer angegebenen Plattform konsistent ist, indem MsiAdvertiseProductExverwendet wird. Die funktion MsiAdvertiseProductEx bietet die gleiche Funktionalität wie MsiAdvertiseProduct.

Syntax

UINT MsiAdvertiseProductExA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage,
  [in] DWORD  dwPlatform,
  [in] DWORD  dwOptions
);

Parameter

[in] szPackagePath

Der vollständige Pfad zum Paket des beworbenen Produkts.

[in] szScriptfilePath

Der vollständige Pfad zur Skriptdatei, die mit den angekündigten Informationen erstellt werden soll. Wenn Sie das Produkt lokal auf dem Computer bewerben möchten, legen Sie ADVERTISEFLAGS_MACHINEASSIGN oder ADVERTISEFLAGS_USERASSIGN fest.

Flagge	Bedeutung
ADVERTISEFLAGS_MACHINEASSIGN 0	Legen Sie fest, dass für alle Benutzer eine Pro-Computer-Installation des Produkts angekündigt wird.
ADVERTISEFLAGS_USERASSIGN 1	Festlegen, dass eine benutzerspezifische Installation des Produkts angekündigt wird, das für einen bestimmten Benutzer verfügbar ist.

[in] szTransforms

Eine durch Semikolons getrennte Liste von Transformationen, die angewendet werden sollen. Die Liste der Transformationen kann dem @- oder | vorangestellt werden. Zeichen zum Angeben des sicheren Zwischenspeicherns von Transformationen. Das Präfix "@" gibt transformationen für sichere Quellen und das | an. Präfix gibt sichere vollständige Pfadtransformationen an. Weitere Informationen finden Sie unter Gesicherte Transformationen. Dieser Parameter kann null sein.

[in] lgidLanguage

Die Sprache, die verwendet werden soll, wenn die Quelle mehrere Sprachen unterstützt.

[in] dwPlatform

Bitkennzeichnungen, die steuern, für welche Plattform das Installationsprogramm das Skript erstellen soll. Dieser Parameter wird ignoriert, wenn szScriptfilePath- null ist. Wenn dwPlatform null (0) ist, wird das Skript basierend auf der aktuellen Plattform erstellt. Dies ist die gleiche Funktionalität wie MsiAdvertiseProduct. Wenn dwPlatform 1 oder 2 ist, erstellt das Installationsprogramm skript für die angegebene Plattform.

Flagge	Bedeutung
keine 0	Erstellt ein Skript für die aktuelle Plattform.
MSIARCHITECTUREFLAGS_X86 1	Erstellt ein Skript für die x86-Plattform.
MSIARCHITECTUREFLAGS_IA64 2	Erstellt ein Skript für Itanium-basierte Systeme.
MSIARCHITECTUREFLAGS_AMD64 4	Erstellt ein Skript für die x64-Plattform.

[in] dwOptions

Bitkennzeichnungen, die zusätzliche Ankündigungsoptionen angeben. Nonzero-Wert ist nur in Windows Installer-Versionen verfügbar, die mit Windows Server 2003 und Windows XP mit SP1 und höher ausgeliefert wurden.

Flagge	Bedeutung
MSIADVERTISEOPTIONS_INSTANCE 1	Mehrere Instanzen durch Ändern des Transformationsunterstützungskennzeichnungscodes. Kündigt eine neue Instanz des Produkts an. Erfordert, dass der szTransforms Parameter die Instanztransformation enthält, die den Produktcode ändert. Weitere Informationen finden Sie unter Installieren mehrerer Instanzen von Produkten und Patches.

Rückgabewert

Wert	Bedeutung
ERROR_SUCCESS	Die Funktion wird erfolgreich abgeschlossen.
Ein Fehler, der sich auf eine Aktion	Weitere Informationen finden Sie unter Fehlercodes.
Initialisierungsfehler	Es ist ein Initialisierungsfehler aufgetreten.
ERROR_CALL_NOT_IMPLEMENTED	Dieser Fehler wird zurückgegeben, wenn versucht wird, ein Werbeskript auf einer anderen Plattform als Windows 2000 oder Windows XP zu generieren. Werbung für den lokalen Computer wird auf allen Plattformen unterstützt.

Bemerkungen

Für windows Installer-Versionen, die mit Windows Server 2003 und Windows XP mit SP1 und höher bereitgestellt werden, stehen mehrere Instanzen über Codeänderungstransformationen zur Verfügung.

Anmerkung

Der msi.h-Header definiert MsiAdvertiseProductEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	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 unter Windows Server 2003 oder Windows XP. Informationen zum mindestens von einer Windows Installer-Version erforderlichen Windows-Service Pack finden Sie unter den Windows Installer-Run-Time Anforderungen.
Zielplattform-	Fenster
Header-	msi.h
Library	Msi.lib
DLL-	Msi.dll

Siehe auch

Multiple-Package Installationen

in Windows Installer 2.0 und früheren nicht unterstützt

Freigeben über