Inscription d’application

Cette rubrique explique comment les applications peuvent exposer les informations sur elles-mêmes nécessaires pour activer certains scénarios. Cela inclut les informations nécessaires pour localiser l’application, les verbes pris en charge par l’application et les types de fichiers qu’une application peut gérer.

Cette rubrique est organisée comme suit :

• Recherche d’un exécutable d’application
• Inscription d’applications
  • Utilisation de la sous-clé Chemins d’accès aux applications
  • Utilisation de la sous-clé Applications
• Inscription de verbes et d’autres informations d’association de fichiers
• Inscription d’un type perçu
• Rubriques connexes

Recherche d’un exécutable d’application

Lorsque la fonction ShellExecuteEx est appelée avec le nom d’un fichier exécutable dans son paramètre lpFile , la fonction recherche le fichier à plusieurs endroits. Nous vous recommandons d’inscrire votre application dans la sous-clé de Registre Chemins d’accès aux applications. Cela évite aux applications de modifier la variable d’environnement PATH système.

Le fichier est recherché aux emplacements suivants :

• Le répertoire de travail actuel
• Répertoire Windows uniquement (aucun sous-répertoire n’est recherché).
• Répertoire Windows\System32 .
• Répertoires répertoriés dans la variable d’environnement PATH.
• Recommandé : chemins d’accès\ del’application MicrosoftWindows\CurrentVersion\HKEY_LOCAL_MACHINE\SOFTWARE\

Inscription d’applications

Les sous-clés de Registre Chemins d’accès aux applications et Applications sont utilisées pour inscrire et contrôler le comportement du système pour le compte des applications. La sous-clé Chemins d’accès aux applications est l’emplacement par défaut.

Utilisation de la sous-clé Chemins d’accès aux applications

Dans Windows 7 et versions ultérieures, nous vous recommandons vivement d’installer des applications par utilisateur plutôt que par ordinateur. Une application installée pour chaque utilisateur peut être inscrite sous HKEY_CURRENT_USER\Chemins d’accès\ del’applicationMicrosoft\Windows\CurrentVersion\. Une application installée pour tous les utilisateurs de l’ordinateur peut être inscrite sous HKEY_LOCAL_MACHINE\Logiciels\Microsoft\Windows\CurrentVersion\App Paths.

Les entrées trouvées sous Chemins d’accès d’application sont principalement utilisées aux fins suivantes :

• Pour mapper le nom de fichier exécutable d’une application au chemin d’accès complet de ce fichier.
• Pour prédéfinier les informations à la variable d’environnement PATH par application et par processus.

Si le nom d’une sous-clé de Chemins d’accès d’application correspond au nom de fichier, l’interpréteur de commandes effectue deux actions :

• L’entrée (par défaut) est utilisée comme chemin d’accès complet du fichier.
• L’entrée Path de cette sous-clé est pré-pendée à la variable d’environnement PATH de ce processus. Si cela n’est pas obligatoire, la valeur path peut être omise.

Les problèmes potentiels à connaître sont les suivants :

• L’interpréteur de commandes limite la longueur d’une ligne de commande à MAX_PATH * 2 caractères. Si de nombreux fichiers sont répertoriés en tant qu’entrées de Registre ou si leurs chemins sont longs, les noms de fichiers plus loin dans la liste peuvent être perdus lorsque la ligne de commande est tronquée.
• Certaines applications n’acceptent pas plusieurs noms de fichiers dans une ligne de commande.
• Certaines applications qui acceptent plusieurs noms de fichiers ne reconnaissent pas le format dans lequel l’interpréteur de commandes les fournit. L’interpréteur de commandes fournit la liste de paramètres sous forme de chaîne entre guillemets, mais certaines applications peuvent nécessiter des chaînes sans guillemets.
• Tous les éléments qui peuvent être déplacés ne font pas partie du système de fichiers ; par exemple, les imprimantes. Ces éléments n’ayant pas de chemin Win32 standard, il n’existe aucun moyen de fournir une valeur lpParameters significative à ShellExecuteEx.

L’utilisation de l’entrée DropTarget permet d’éviter ces problèmes potentiels en fournissant l’accès à tous les formats du Presse-papiers, y compris les CFSTR_SHELLIDLIST (pour les listes de fichiers longues) et les CFSTR_FILECONTENTS (pour les objets non système de fichiers).

Pour inscrire et contrôler le comportement de vos applications avec la sous-clé Chemins d’accès aux applications :

1. Ajoutez une sous-clé portant le même nom que votre fichier exécutable à la sous-clé Chemins d’accès aux applications, comme indiqué dans l’entrée de Registre suivante.

   HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER
      SOFTWARE
         Microsoft
            Windows
               CurrentVersion
                  App Paths
                     file.exe
                        (Default)
                        DontUseDesktopChangeRouter
                        DropTarget
                        Path
                        UseUrl
   

2. Consultez le tableau suivant pour plus d’informations sur les entrées de sous-clé Chemins d’accès aux applications.

Utilisation de la sous-clé Applications

Grâce à l’inclusion d’entrées de Registre sous la sous-clé HKEY_CLASSES_ROOT\Applications\ApplicationName.exe , les applications peuvent fournir les informations spécifiques à l’application indiquées dans le tableau suivant.

Exemples

Voici quelques exemples d’inscriptions d’applications via la sous-clé HKEY_CLASSES_ROOT\Applications\ApplicationName.exe . Toutes les valeurs d’entrée de Registre sont de REG_SZ type, à l’exception de DefaultIcon qui est de REG_EXPAND_SZ type.

HKEY_CLASSES_ROOT
   Applications
      wordpad.exe
         FriendlyAppName = @%SystemRoot%\System32\shell32.dll,-22069

HKEY_CLASSES_ROOT
   Applications
      wmplayer.exe
         SupportedTypes
            .3gp2

HKEY_CLASSES_ROOT
   Applications
      wmplayer.exe
         DefaultIcon
            (Default) = %SystemRoot%\system32\wmploc.dll,-730

HKEY_CLASSES_ROOT
   Applications
      WScript.exe
         NoOpenWith

HKEY_CLASSES_ROOT
   Applications
      photoviewer.dll
         shell
            open
               DropTarget
                  Clsid = {FFE2A43C-56B9-4bf5-9A79-CC6D4285608A}

HKEY_CLASSES_ROOT
   Applications
      mspaint.exe
         SupportedTypes
            .bmp
            .dib
            .rle
            .jpg
            .jpeg
            .jpe
            .jfif
            .gif
            .emf
            .wmf
            .tif
            .tiff
            .png
            .ico

Inscription de verbes et d’autres informations d’association de fichiers

Les sous-clés inscrites sous HKEY_CLASSES_ROOT\SystemFileAssociations permettent à l’interpréteur de commandes de définir le comportement par défaut des attributs pour les types de fichiers et d’activer les associations de fichiers partagés. Lorsque les utilisateurs modifient l’application par défaut pour un type de fichier, le ProgID de la nouvelle application par défaut a la priorité de fournir des verbes et d’autres informations d’association. Cette priorité est due au fait qu’il s’agit de la première entrée dans le tableau d’association. Si le programme par défaut est modifié, les informations sous le ProgID précédent ne sont plus disponibles.

Pour gérer de manière proactive les conséquences d’une modification des programmes par défaut, vous pouvez utiliser HKEY_CLASSES_ROOT\SystemFileAssociations pour inscrire des verbes et d’autres informations d’association. En raison de leur emplacement après le ProgID dans le tableau d’association, ces inscriptions sont de priorité inférieure. Ces SystemFileAssociationsregistrations sont stables même lorsque les utilisateurs modifient les programmes par défaut et fournissent un emplacement pour inscrire des verbes secondaires qui seront toujours disponibles pour un type de fichier particulier. Pour obtenir un exemple de Registre, consultez Inscription d’un type perçu plus loin dans cette rubrique.

L’exemple de Registre suivant montre ce qui se passe lorsque l’utilisateur exécute l’élément Programmes par défaut dans Panneau de configuration pour modifier la valeur par défaut des fichiers .mp3 en App2ProgID. Après avoir modifié la valeur par défaut, Verb1 n’est plus disponible et Verb2 devient la valeur par défaut.

HKEY_CLASSES_ROOT
   .mp3
      (Default) = App1ProgID

HKEY_CLASSES_ROOT
   App1ProgID
      shell
         Verb1

HKEY_CLASSES_ROOT
   App2ProgID
      shell
         Verb2

Inscription d’un type perçu

Les valeurs de Registre pour les types perçus sont définies en tant que sous-clés de la sous-clé de RegistreSystemFileAssociationsHKEY_CLASSES_ROOT\. Par exemple, le texte de type perçu est inscrit comme suit :

HKEY_CLASSES_ROOT
   SystemFileAssociations
      text
         shell
            edit
               command
                  (Default) = "%SystemRoot%\system32\NOTEPAD.EXE" "%1"
            open
               command
                  (Default) = "%SystemRoot%\system32\NOTEPAD.EXE" "%1"

Le type perçu d’un type de fichier est indiqué en incluant une valeur PerceivedType dans la sous-clé du type de fichier. La valeur PerceivedType est définie sur le nom du type perçu inscrit sous HKEY_CLASSES_ROOT sous la\ sous-clé de RegistreSystemFileAssociations, comme indiqué dans l’exemple de Registre précédent. Pour déclarer les fichiers .cpp comme étant de type « texte », par exemple, ajoutez l’entrée de Registre suivante :

HKEY_CLASSES_ROOT
   .cpp
      PerceivedType = text

Rubriques connexes

Types de fichiers

Fonctionnement des associations de fichiers

Affichage de contenu par type de fichier ou par type de fichier

Vérificateur de type de fichier

Gestionnaires de types de fichiers

Identificateurs programmatiques

Types perçus

Tableaux d’association