MsiProcessAdvertiseScriptW-Funktion (msi.h)

Artikel
08/24/2023

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

Syntax

UINT MsiProcessAdvertiseScriptW(
  [in] LPCWSTR szScriptFile,
  [in] LPCWSTR 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 wird.

[in] szIconFolder

Ein optionaler Pfad zu einem Ordner, in dem sich angekündigte Symbol- 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 Tastenkombinationen.

[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.
Ein Fehler im Zusammenhang mit einer Aktion	Weitere Informationen finden Sie unter Fehlercodes.
Initialisierungsfehler	Fehler im Zusammenhang mit der 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 benutzerspezifische Installation 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, keine Identität eines Zielbenutzers angibt, wird die Anwendung allen Benutzern zur Installation mit erhöhten Berechtigungen angekündigt.

Hinweis

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

Share via