MsiProcessAdvertiseScriptA-Funktion (msi.h)
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 |
---|---|
|
Die Funktion wurde erfolgreich abgeschlossen. |
|
Der aufrufende Prozess wurde nicht unter dem LocalSystem-Konto ausgeführt. |
|
Weitere Informationen finden Sie unter Fehlercodes. |
Fehler in Bezug auf die Initialisierung. | |
|
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 |