MsiProcessAdvertiseScriptA-Funktion (msi.h)

Artikel
02/29/2024

Die MsiProcessAdvertiseScript-Funktion verarbeitet eine Ankündigungsskriptdatei an den angegebenen Speicherorten.

Syntax

UINT MsiProcessAdvertiseScriptA(
  [in] LPCSTR szScriptFile,
  [in] LPCSTR szIconFolder,
  [in] HKEY   hRegData,
  [in] BOOL   fShortcuts,
  [in] BOOL   fRemoveItems
);

Parameter

[in] szScriptFile

Der vollständige Pfad zu einer Skriptdatei, die von MsiAdvertiseProduct oder MsiAdvertiseProductEx generiert wurde.

[in] szIconFolder

Ein optionaler Pfad zu einem Ordner, in dem sich angekündigte Symboldateien und Transformationsdateien befinden. Wenn dieser Parameter NULL ist, werden keine Symbol- oder Transformationsdateien geschrieben.

[in] hRegData

Ein Registrierungsschlüssel, unter dem Registrierungsdaten geschrieben werden sollen. Wenn dieser Parameter NULL ist, schreibt das Installationsprogramm die Registrierungsdaten unter den entsprechenden Schlüssel, je nachdem, ob die Ankündigung pro Benutzer oder pro Computer erfolgt. Wenn dieser Parameter nicht NULL ist, schreibt das Skript die Registrierungsdaten unter dem angegebenen Registrierungsschlüssel anstelle des normalen Speicherorts. In diesem Fall wird die Anwendung dem Benutzer nicht angekündigt.

[in] fShortcuts

TRUE , wenn Verknüpfungen erstellt werden sollen. Wenn ein spezieller Ordner von SHGetSpecialFolderLocation zurückgegeben wird, enthält er die Verknüpfungen.

[in] fRemoveItems

TRUE , wenn angegebene Elemente entfernt und nicht erstellt werden sollen.

Rückgabewert

Wert	Bedeutung
ERROR_SUCCESS	Die Funktion wurde erfolgreich abgeschlossen.
ERROR_ACCESS_DENIED	Der aufrufende Prozess wurde nicht unter dem LocalSystem-Konto ausgeführt.
Fehler im Zusammenhang mit einer Aktion	Weitere Informationen finden Sie unter Fehlercodes.
Initialisierungsfehler	Fehler in Bezug auf die Initialisierung.
ERROR_CALL_NOT_IMPLEMENTED	Diese Funktion ist für diese Plattform nicht verfügbar.

Hinweise

Der Prozess, der diese Funktion aufruft, muss unter dem LocalSystem-Konto ausgeführt werden. Um eine Anwendung für die Installation pro Benutzer für einen Zielbenutzer anzukündigen, muss der Thread, der diese Funktion aufruft, die Identität des Zielbenutzers annehmen. Wenn der Thread, der diese Funktion aufruft, die Identität eines Zielbenutzers nicht angibt, wird die Anwendung allen Benutzern zur Installation mit erhöhten Rechten angekündigt.

Hinweis

Der msi.h-Header definiert MsiProcessAdvertiseScript als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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