MsiAdvertiseProductExA-Funktion (msi.h)

Artikel
08/24/2023

Die MsiAdvertiseProductEx-Funktion generiert ein Werbeskript oder kündigt ein Produkt auf dem Computer an. Mit dieser Funktion kann Windows Installer die Registrierungs- und Verknüpfungsinformationen, die zum Zuweisen oder Veröffentlichen eines Produkts verwendet werden, in ein Skript schreiben. Das Skript kann mithilfe von MsiAdvertiseProductEx so geschrieben werden, dass es mit einer angegebenen Plattform konsistent ist. Die MsiAdvertiseProductEx-Funktion 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. Um das Produkt lokal auf dem Computer anzukündigen, legen Sie ADVERTISEFLAGS_MACHINEASSIGN oder ADVERTISEFLAGS_USERASSIGN fest.

Flag	Bedeutung
ADVERTISEFLAGS_MACHINEASSIGN 0	Legen Sie fest, um eine computerspezifische Installation des Produkts anzukündigen, das für alle Benutzer verfügbar ist.
ADVERTISEFLAGS_USERASSIGN 1	Legen Sie fest, um eine benutzerspezifische Installation des Produkts anzukündigen, das für einen bestimmten Benutzer verfügbar ist.

[in] szTransforms

Eine durch Semikolons getrennte Liste von Transformationen, die angewendet werden sollen. Der Liste der Transformationen kann das Präfix @ oder | zeichen, um die sichere Zwischenspeicherung von Transformationen anzugeben. Das Präfix @ gibt Secure-at-Source-Transformationen und die | präfix gibt sichere vollständige Pfadtransformationen an. Weitere Informationen finden Sie unter Geschützte Transformationen. Dieser Parameter kann NULL sein.

[in] lgidLanguage

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

[in] dwPlatform

Bitflags, 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 ein Skript für die angegebene Plattform.

Flag	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

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

Flag	Bedeutung
MSIADVERTISEOPTIONS_INSTANCE 1	Mehrere Instanzen über den Produktcode, der das Transformationsunterstützungsflag ändert. Kündigt eine neue Instanz des Produkts an. Erfordert, dass der szTransforms-Parameter die instance Transformation 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 bezieht	Weitere Informationen finden Sie unter Fehlercodes.
Initialisierungsfehler	Ein Initialisierungsfehler ist 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. Die Werbung für den lokalen Computer wird auf allen Plattformen unterstützt.

Hinweise

Mehrere Instanzen über Den Produktcode ändernde Transformationen sind nur für Windows Installer-Versionen verfügbar, die mit Windows Server 2003 und Windows XP mit SP1 und höher bereitgestellt werden.

Hinweis

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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (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 erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen.
Zielplattform	Windows
Kopfzeile	msi.h
Bibliothek	Msi.lib
DLL	Msi.dll

Weitere Informationen

Installationen mit mehreren Paketen

In Windows Installer 2.0 und früher nicht unterstützt

Freigeben über