InstallApplication, fonction (appmgmt.h)
La fonction InstallApplication peut installer des applications qui ont été déployées sur des utilisateurs cibles appartenant à un domaine. Le contexte de sécurité de l’utilisateur qui appelle InstallApplication doit être celui d’un utilisateur de domaine connecté sur un ordinateur dans un domaine qui approuve le domaine de l’utilisateur cible. stratégie de groupe doit être correctement appliqué lorsque l’utilisateur cible se connecte.
Syntaxe
DWORD InstallApplication(
[in] PINSTALLDATA pInstallInfo
);
Paramètres
[in] pInstallInfo
Pointeur vers une structure INSTALLDATA qui spécifie l’application à installer.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. Sinon, la fonction retourne l’un des codes d’erreur système. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur système ou le fichier d’en-tête WinError.h.
Remarques
La fonction InstallApplication ne peut installer que les applications qui ont été déployées à l’aide de stratégie de groupe. Un administrateur de domaine peut déployer des applications sur des utilisateurs cibles à l’aide de la section configuration utilisateur de stratégie de groupe Objects (GPO). L’utilisateur cible doit appartenir au domaine cible et l’objet de stratégie de groupe doit s’appliquer à cet utilisateur dans le domaine cible. La fonction InstallApplication installe les applications selon les règles d’héritage standard stratégie de groupe. Si la même application est déployée dans plusieurs objets de stratégie de groupe, la fonction installe la version de l’application déployée dans l’objet de stratégie de groupe de priorité le plus élevé. Une fois qu’une application a été installée pour un utilisateur, elle n’est pas visible par les autres utilisateurs sur l’ordinateur. Il s’agit d’une norme pour les applications déployées via une stratégie de groupe d’utilisateurs.
La fonction InstallApplication peut installer des applications déployées qui utilisent Windows Installer (fichiers .msi) ou des paramètres d’installation de logiciels (fichiers .zap) pour gérer l’installation et l’installation.
La fonction InstallApplication peut installer des applications qui utilisent un package Windows Installer pour leur installation. Dans ce cas, l’utilisateur qui appelle InstallApplication n’est pas tenu de disposer de privilèges d’administrateur. Le système peut installer l’application, car Windows Installer est une application approuvée déployée par un administrateur de domaine. L’utilisateur qui reçoit l’application doit avoir accès à l’emplacement des fichiers .msi.
Supprimez les applications installées à l’aide de fichiers .msi en appelant la fonction Windows InstallerMsiConfigureProduct pour désinstaller l’application. Appelez ensuite UninstallApplication pour informer le système que l’application n’est plus gérée sur le client par stratégie de groupe. UninstallApplication doit être appelé même si la désinstallation échoue, car cela permet au système de conserver l’ensemble de stratégie résultant (RSoP) exact.
La fonction InstallApplication peut également installer des applications qui utilisent des applications d’installation basées sur les paramètres d’installation du logiciel (fichiers .zap). L’utilisateur qui reçoit l’application doit avoir accès à l’emplacement des fichiers .zap. Un fichier .zap est un fichier texte similaire à un fichier .ini, qui permet à Windows de publier une application (par exemple, Setup.exe) pour l’installation avec Ajout/Suppression de programmes. Pour publier des applications qui n’utilisent pas Windows Installer, vous devez créer un fichier .zap, copier le fichier .zap sur les serveurs de points de distribution de logiciels, puis utiliser stratégie de groupe déploiement logiciel pour publier l’application pour les utilisateurs. Si l’application est déployée à l’aide de fichiers .zap, l’utilisateur qui installe l’application doit disposer de privilèges sur l’ordinateur pour installer le logiciel. Vous ne pouvez pas utiliser les fichiers .zap pour les applications affectées.
Supprimez les applications à l’aide des paramètres d’installation de logiciels (fichiers .zap) en appelant la fonction uninstall ou une commande spécifique à l’application d’installation.
Pour plus d’informations sur l’utilisation d’applications d’installation autres que Windows Installer , consultez l’article 231747, « Comment publier des programmes non MSI avec des fichiers .zap » dans la Base de connaissances Microsoft.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | appmgmt.h |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |
| Ensemble d’API | ext-ms-win-advapi32-msi-l1-1-0 (introduit dans Windows 8) |
Voir aussi
Vue d’ensemble de la stratégie de groupe