MsiAdvertiseProductA-Funktion (msi.h)

  • Artikel

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