MsiProcessAdvertiseScriptW-Funktion (msi.h)

Artikel
11/20/2024

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 MsiAdvertiseProductExgeneriert wird.

[in] szIconFolder

Ein optionaler Pfad zu einem Ordner, in dem angekündigte Symboldateien und Transformationsdateien gespeichert sind. 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 dem entsprechenden Schlüssel, basierend darauf, ob die Ankündigung pro Benutzer oder pro Computer ist. Wenn dieser Parameter nichtNULL-ist, schreibt das Skript die Registrierungsdaten unter den angegebenen Registrierungsschlüssel und nicht in den normalen Speicherort. 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 werden sollen, anstatt erstellt zu werden.

Rückgabewert

Wert	Bedeutung
ERROR_SUCCESS	Die Funktion wurde erfolgreich abgeschlossen.
ERROR_ACCESS_DENIED	Der Aufrufvorgang wurde nicht unter dem LocalSystem-Konto ausgeführt.
Ein Fehler im Zusammenhang mit einer Aktion	Siehe Fehlercodes.
Initialisierungsfehler	Fehler im Zusammenhang mit der Initialisierung.
ERROR_CALL_NOT_IMPLEMENTED	Diese Funktion ist für diese Plattform nicht verfügbar.

Bemerkungen

Der Prozess, der diese Funktion aufruft, muss unter dem LocalSystem-Konto ausgeführt werden. Um eine Anwendung für die Benutzerinstallation für einen benutzerbezogenen Benutzer ankündigen zu können, muss der Thread, der diese Funktion aufruft, den Zielbenutzer imitieren. Wenn der Thread, der diese Funktion aufruft, keine Identität eines zielbezogenen Benutzers angibt, wird die Anwendung für alle Benutzer für die Installation mit erhöhten Berechtigungen angekündigt.

Anmerkung

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

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

Freigeben über