MsiAdvertiseProductA-Funktion (msi.h)

Artikel
08/24/2023

Die MsiAdvertiseProduct-Funktion generiert ein Ankündigungsskript oder kündigt ein Produkt an den Computer an. Mit der MsiAdvertiseProduct-Funktion kann der 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.

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 Ankündigungsinformationen erstellt wird. 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 einem bestimmten Benutzer zur Verfügung steht.

[in] szTransforms

Eine durch Semikolon getrennte Liste von Transformationen, die angewendet werden sollen. Der Liste der Transformationen kann das Präfix @ oder | -Zeichen, um das sichere Zwischenspeichern von Transformationen anzugeben. Das Präfix @gibt Secure-at-Source-Transformationen und die | prefix 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	Weitere Informationen finden Sie unter Fehlercodes.
Initialisierungsfehler	Initialisierungsfehler.
ERROR_CALL_NOT_IMPLEMENTED	Dieser Fehler wird zurückgegeben, wenn versucht wird, ein Ankündigungsskript auf einer anderen Plattform als Windows 2000 oder Windows XP zu generieren. Werbung für den lokalen Computer wird auf allen Plattformen unterstützt.

Hinweise

Hinweis

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


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

Freigeben über