Gestion des sources d’installation

Les utilisateurs et applications disposant de privilèges d’administration peuvent récupérer et modifier les informations de liste de sources réseau, URL et multimédias pour les applications Windows Installer et les correctifs sur le système.

Windows Installer 2.0 : Non pris en charge. Les administrateurs ne peuvent pas lire, réorganiser ou remplacer les entrées de la liste de sources et ne peuvent pas modifier ou récupérer les propriétés de la liste source. Il est possible de gérer les sources réseau, mais pas les sources d’URL ou multimédias. Les administrateurs peuvent uniquement gérer les listes de sources pour les applications par ordinateur ou les applications installées par utilisateur pour l’utilisateur actuel. Cela empêche les administrateurs qui utilisent des versions antérieures à Windows Installer version 3.0 de gérer les informations de liste de sources pour tous les utilisateurs du système.

Windows Installer 3.0 et versions ultérieures : Les utilisateurs et les applications disposant de privilèges d’administrateur peuvent récupérer et modifier les informations de liste des sources pour les applications Windows Installer et les correctifs installés sur le système pour tous les utilisateurs. Les fonctions de liste de sources peuvent être utilisées pour gérer les listes de sources et les propriétés de liste de sources pour les sources réseau, URL et multimédias. Le programme d’installation peut réorganiser les listes de sources à partir d’un processus externe.

Les utilisateurs et les applications qui disposent de privilèges administratifs peuvent lire et modifier les types d’informations de liste de sources suivants :

  • Listes de sources pour les applications et correctifs installés pour tous les utilisateurs sur le système.
  • Listes de sources pour les sources de correctifs qui existent en dehors des sources d’application.
  • Listes de sources pour les sources d’URL et multimédias qui existent en dehors des sources réseau.
  • Propriétés de liste de sources, comme MEDIAPACKAGEPATH, DiskPrompt, LastUsedSource, LastUsedType et PackageName.

Les fonctions de listes de sources peuvent limiter l’étendue des listes de sources trouvées en spécifiant le contexte d’installation et le contexte utilisateur. Il existe trois contextes d’installation possibles : par utilisateur (non managé), par machine et par utilisateur géré. Le contexte utilisateur peut être un utilisateur particulier ou tous les utilisateurs du système.

Les non-administrateurs ne peuvent pas modifier la liste de sources d’une instance d’une application ou d’un correctif qui existe dans le contexte par utilisateur d’un autre utilisateur (managé ou non managé). Les non-administrateurs peuvent modifier les listes de sources d’une instance d’une application ou d’un correctif installé dans les contextes suivants :

Les administrateurs peuvent modifier toute liste de sources qu’un non-administrateur peut modifier. En outre, les administrateurs et les applications qui disposent de privilèges administratifs peuvent modifier les listes de sources d’une application ou d’un correctif installé dans les contextes suivants :

  • Contexte par machine.
  • Leur propre contexte managé par utilisateur (non managé) ou par utilisateur.
  • Contexte managé par utilisateur d’un autre utilisateur.

Notes

Les utilisateurs et les applications qui disposent de privilèges d’administration ne peuvent pas modifier la liste de sources d’une instance d’une application ou d’un correctif installée dans le contexte par utilisateur (non managé) d’un autre utilisateur.

 

Gestion des sources réseau et URL pour les produits et les correctifs

Utilisez la fonction MsiSourceListAddSourceEx pour ajouter ou réorganiser la liste des sources de réseau et d’URL pour un correctif ou une application dans un contexte particulier. Utilisez le paramètre dwContext pour spécifier le contexte d’installation. Utilisez le paramètre szUserSid pour spécifier le contexte utilisateur.

Utilisez la fonction MsiSourceListAddSourceEx pour créer une liste de sources pour un correctif qui n’a pas encore été appliqué à une application dans le contexte spécifié. Cela peut être utile lors de l’inscription d’un correctif pour avoir des privilèges élevés. Pour plus d’informations sur l’inscription de privilèges élevés pour un correctif, consultez Mise à jour corrective des applications gérées par utilisateur.

Utilisez la fonction MsiSourceListClearSource pour supprimer une source existante pour une application ou un correctif dans un contexte spécifié. La suppression de la source actuelle d’une application ou d’un correctif force le programme d’installation à rechercher une source dans la liste de sources la prochaine fois qu’une source est requise.

Utilisez la fonction MsiSourceListEnumSources pour énumérer les sources dans la liste des sources d’un correctif ou d’une application spécifié.

Gestion des sources multimédias pour les produits et les correctifs

Utilisez la fonction MsiSourceListAddMediaDisk pour ajouter ou mettre à jour les informations de disque de la source multimédia d’une application ou d’un correctif inscrit. Chaque entrée est identifiée de manière unique par un ID de disque. Si le disque existe déjà, il est mis à jour avec les nouvelles valeurs d’étiquette de volume et d’invite de disque. Si le disque n’existe pas, une nouvelle entrée de disque est créée avec les nouvelles valeurs.

Utilisez la fonction MsiSourceListClearMediaDisk pour supprimer un disque inscrit existant sous la source multimédia d’une application ou d’un correctif dans un contexte spécifique.

Utilisez la fonction MsiSourceListEnumMediaDisks pour énumérer une liste de disques inscrits sous la source multimédia pour une application ou un correctif.

Récupération et modification des informations de liste de sources

Utilisez les fonctions MsiSourceListGetInfo et MsiSourceListSetInfo pour récupérer ou modifier des informations sur la liste de sources d’une application ou d’un correctif dans un contexte spécifique. Utilisez le paramètre dwContext pour spécifier le contexte d’installation. Utilisez le paramètre szUserSid pour spécifier le contexte utilisateur.

Les propriétés de liste de sources, comme MEDIAPACKAGEPATH, DiskPrompt, LastUsedSource, LastUsedType et PackageName sont accessibles.

Notes

La propriété de liste de sources LastUsedType est uniquement accessible en lecture. Elle ne peut pas être définie directement à l’aide de la fonction MsiSourceListSetInfo.

 

Effacer de la liste de sources complète ou forcer une résolution de source

Utilisez la fonction MsiSourceListClearAllEx pour supprimer toutes les sources existantes d’un type de source donné pour l’instance d’application ou de correctif spécifiée. L’inscription du correctif est également supprimée si le correctif n’est installé par aucune application dans le même contexte. Utilisez le paramètre dwContext pour spécifier le contexte d’installation. Utilisez le paramètre szUserSid pour spécifier le contexte utilisateur.

Utilisez MsiSourceListForceResolutionEx pour effacer la dernière entrée source utilisée pour une application ou un correctif dans le contexte spécifié. Cette fonction supprime l’inscription de la propriété appelée LastUsedSource. Cette fonction n’affecte pas la liste de sources inscrite. L’effacement de l’inscription LastUsedSource force le programme d’installation à effectuer une résolution de source par rapport aux sources inscrites la prochaine fois qu’il a besoin de la source.