MsiAdvertiseProductA-Funktion (msi.h)

Artikel
11/20/2024

Die MsiAdvertiseProduct--Funktion generiert ein Werbeskript oder kündigt ein Produkt auf dem Computer an. Die MsiAdvertiseProduct--Funktion ermöglicht es dem Installer, in ein Skript zu 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.

Syntax

UINT MsiAdvertiseProductA(
  [in] LPCSTR szPackagePath,
  [in] LPCSTR szScriptfilePath,
  [in] LPCSTR szTransforms,
  [in] LANGID lgidLanguage
);

Parameter

[in] szPackagePath

Der vollständige Pfad zum Paket des beworbenen Produkts.

[in] szScriptfilePath

Der vollständige Pfad zur Skriptdatei, die mit den Werbeinformationen erstellt wird. 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 Installationssprache, die verwendet werden soll, wenn die Quelle mehrere Sprachen unterstützt.

Rückgabewert

Wert	Bedeutung
ERROR_SUCCESS	Die Funktion wurde erfolgreich abgeschlossen.
Ein Fehler im Zusammenhang mit einer Aktion	Siehe 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. Werbung für den lokalen Computer wird auf allen Plattformen unterstützt.

Bemerkungen

Anmerkung

Der msi.h-Header definiert MsiAdvertiseProduct 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

Freigeben über