MsiProcessAdvertiseScriptA, fonction (msi.h)
La fonction MsiProcessAdvertiseScript traite un fichier de script de publication dans les emplacements spécifiés.
Syntaxe
UINT MsiProcessAdvertiseScriptA(
[in] LPCSTR szScriptFile,
[in] LPCSTR szIconFolder,
[in] HKEY hRegData,
[in] BOOL fShortcuts,
[in] BOOL fRemoveItems
);
Paramètres
[in] szScriptFile
Chemin complet d’un fichier de script généré par MsiAdvertiseProduct ou MsiAdvertiseProductEx.
[in] szIconFolder
Chemin facultatif d’un dossier dans lequel se trouvent les fichiers d’icônes publiés et les fichiers de transformation. Si ce paramètre est NULL, aucune icône ou fichier de transformation n’est écrit.
[in] hRegData
Clé de Registre sous laquelle les données de Registre doivent être écrites. Si ce paramètre est NULL, le programme d’installation écrit les données de Registre sous la clé appropriée, selon que la publicité est par utilisateur ou par ordinateur. Si ce paramètre n’est pasNULL, le script écrit les données de Registre sous la clé de Registre spécifiée plutôt que l’emplacement normal. Dans ce cas, l’application n’est pas annoncée à l’utilisateur.
[in] fShortcuts
TRUE si des raccourcis doivent être créés. Si un dossier spécial est retourné par SHGetSpecialFolderLocation il contiendra les raccourcis.
[in] fRemoveItems
TRUE si les éléments spécifiés doivent être supprimés au lieu de créer.
Valeur de retour
Valeur | Signification |
---|---|
|
La fonction s’est terminée correctement. |
|
Le processus appelant n’était pas en cours d’exécution sous le compte LocalSystem. |
|
Consultez codes d’erreur. |
Une erreur liée à l’initialisation s’est produite. | |
|
Cette fonction n’est pas disponible pour cette plateforme. |
Remarques
Le processus appelant cette fonction doit s’exécuter sous le compte LocalSystem. Pour publier une application pour l’installation par utilisateur auprès d’un utilisateur ciblé, le thread qui appelle cette fonction doit emprunter l’identité de l’utilisateur ciblé. Si le thread appelant cette fonction n’emprunte pas l’identité d’un utilisateur ciblé, l’application est annoncée à tous les utilisateurs pour l’installation avec des privilèges élevés.
Note
L’en-tête msi.h définit MsiProcessAdvertiseScript comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer. |
plateforme cible | Windows |
d’en-tête | msi.h |
bibliothèque | Msi.lib |
DLL | Msi.dll |