Inscription d’application

Cette rubrique explique comment les applications peuvent exposer des informations sur elles-mêmes nécessaires pour activer certains scénarios. Cela inclut des 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
• Inscrire des applications
  • à l’aide de la sous-clé chemins d’application
  • à l’aide de la sous-clé Applications
• inscrire des verbes et d’autres informations d’association de fichiers
• Inscrire un de 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, il existe plusieurs emplacements où la fonction recherche le fichier. Nous vous recommandons d’inscrire votre application dans la sous-clé de Registre chemins d’application. Cela évite la nécessité pour les applications de modifier la variable d’environnement PATH système.

Le fichier est recherché aux emplacements suivants :

• Répertoire de travail actuel.
• Le 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é : HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths

Inscription d’applications

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

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

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\Software\Microsoft\Windows\CurrentVersion\App Paths. Une application installée pour tous les utilisateurs de l’ordinateur peut être inscrite sous HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\App Paths.

Les entrées trouvées sous chemins d’accès aux applications sont utilisées principalement à des fins suivantes :

• Pour mapper le nom de fichier exécutable d’une application au chemin complet de ce fichier.
• Pour pré-pender des informations sur la variable d’environnement PATH par application, par processus.

Si le nom d’une sous-clé de chemins 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 complet du fichier.
• L’entrée Path de cette sous-clé est pré-pendée à la variable d’environnement PATH de ce processus. Si ce n’est pas nécessaire, la valeur Path peut être omise.

Les problèmes potentiels à prendre en compte sont les suivants :

• L’interpréteur de commandes limite la longueur d’une ligne de commande à MAX_PATH * 2 caractères. S’il existe de nombreux fichiers répertoriés en tant qu’entrées de Registre ou que leurs chemins d’accès sont longs, les noms de fichiers plus loin dans la liste peuvent être perdus à mesure que 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’ont pas de chemin Win32 standard. Il n’existe donc aucun moyen de fournir une valeur significative lpParameters pour ShellExecuteEx.

L’utilisation de l’entrée DropTarget évite ces problèmes potentiels en fournissant l’accès à tous les formats 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’application, 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’application.

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 type REG_SZ, à l’exception de DefaultIcon de type REG_EXPAND_SZ.

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ées. 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é en fournissant des verbes et d’autres informations d’association. Cette priorité est due à sa première entrée dans le tableau d’associations. 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 prioritaires. 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 Inscrire 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 le Panneau de configuration pour modifier la valeur par défaut des fichiers .mp3 sur 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 Registre HKEY_CLASSES_ROOT\SystemFileAssociations sous-clé de Registre. Par exemple, le type perçu texte 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 enregistré sous HKEY_CLASSES_ROOT\SystemFileAssociations sous-clé de Registre, comme indiqué dans l’exemple de Registre précédent. Pour déclarer .cpp fichiers comme étant de type « text », 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

vue de contenu par type de fichier ou type

du vérificateur de type de fichier

gestionnaires de types de fichiers

identificateurs programmatiques

types perçus

Tableaux d’associations