Inscription de programmes avec des types de clients
cette rubrique explique comment inscrire un programme dans le registre Windows en tant qu’un des types de client suivants : navigateur, courrier électronique, lecture multimédia, messagerie instantanée ou machine virtuelle pour Java.
Notes
Ces informations s’appliquent aux systèmes d’exploitation suivants :
- Windows 2000 Service Pack 3 (SP3)
- Windows 2000 Service Pack 4 (SP4)
- Windows XP Service Pack 1 (SP1)
- Windows XP Service Pack 2 (SP2)
- Windows XP Service Pack 3 (SP3)
- Windows Server 2003
- Windows Vista
- Windows Vista Service Pack 1 (SP1)
- Windows 8
Cette rubrique comprend les sections suivantes.
- Éléments d’inscription courants pour tous les types de clients
- Éléments d’inscription pour des types de client spécifiques
- Compléter les exemples d’inscriptions
- Rubriques connexes
Cette rubrique étend la documentation existante sur l’inscription d’un programme en tant que type de client particulier. Pour obtenir des liens vers cette documentation, consultez la section Rubriques connexes.
Éléments d’inscription courants pour tous les types de clients
Lors de l’inscription d’un programme en tant que type de client, la plupart des entrées de Registre sont les mêmes, quel que soit le type de client. Certaines entrées du Registre, toutefois, sont spécifiques au type de client et sont indiquées dans la section éléments d’inscription pour des types de client spécifiques .
Cette section aborde les sujets suivants :
- Sélection d’un nom canonique
- Inscription du nom complet d’un programme
- Inscription de l’icône d’un programme
- Inscription d’un verbe ouvert
- Inscription des informations d’installation
Notes
Les noms de sous-clés donnés en italiques dans cette rubrique sont des espaces réservés pour les noms de sous-clés définis par l’utilisateur ou un ensemble de valeurs possibles. Des exemples complets avec des exemples de noms en place sont fournis dans la section inscriptions des exemples complets .
Toutes les informations d’inscription de type client sont stockées sous la sous-clé suivante :
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
ClientTypeName est l’un des noms de sous-clés suivants :
- StartMenuInternet (pour les navigateurs)
- Courrier électronique (pour courrier électronique)
- Média (pour la lecture du média)
- MESSAGERIE instantanée (pour la messagerie instantanée)
- JavaVM (pour machine virtuelle Java)
Tout au long de cette rubrique, vous allez noter des références à un programme informatique fictif nommé « lit View » par Litware Inc., avec un fichier exécutable nommé Litview.exe. Ce programme hypothétique est utilisé de manière interchangeable comme une messagerie instantanée, un navigateur ou un autre type de programme client si nécessaire à des fins d’illustration.
Sélection d’un nom canonique
Le fournisseur doit choisir un nom canonique pour le programme. Le nom canonique n’est jamais présenté à l’utilisateur, il n’est donc pas nécessaire de le localiser. Son seul objectif est de fournir une chaîne unique qui peut être utilisée pour identifier le programme. Il est généralement identique au nom anglais du programme, mais il s’agit simplement d’une convention.
Pour les types de clients autres que les navigateurs, le nom canonique peut être n’importe quelle chaîne. Choisissez un nom unique, qui n’est pas susceptible d’être utilisé par un autre fournisseur.
Pour les clients de navigateur, le nom canonique doit être le nom, y compris l’extension, du fichier exécutable associé ; par exemple, « Litview.exe ».
Voici quelques exemples de noms canoniques.
- Iexplore.exe (navigateur)
- Windows Courrier électronique (e-mail)
- Lecteur Windows Media (support)
- Windows Messenger (messagerie instantanée)
Inscrivez le nom canonique en créant une sous-clé comme indiqué ici. Le nom de la sous-clé est le nom canonique. Toutes les informations relatives à l’inscription de ce programme se trouvent sous cette sous-clé.
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
CanonicalName
Inscription du nom complet d’un programme
L’étape suivante de l’inscription consiste à spécifier le nom d’affichage du programme. Elle est fournie sous la forme d’une valeur sous la clé de nom canonique comme indiqué ici. Notez à nouveau que CanonicalName et ClientTypeName ne sont pas les noms réels des clés, mais uniquement des espaces réservés pour les véritables noms, tels que lit View.
Notes
à partir de Windows 8, le nom utilisé pour l’inscription pour les paramètres par défaut de l’accès aux programmes et de l' ordinateur (SPAD) et pour les programmes par défaut doit correspondre pour que les modifications de SPAD déclenchent les inscriptions des programmes par défaut.
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
CanonicalName
LocalizedString = @FilePath,-StringID
La valeur LocalizedString est une _ chaîne sz reg et se compose d’un signe « at » (@), du chemin d’accès complet à un fichier .dll ou .exe, d’une virgule, d’un signe moins et d’un entier décimal. L’entier décimal est l’ID d’une ressource de type chaîne, contenue dans le fichier .dll ou .exe, dont la valeur doit être affichée à l’utilisateur en tant que nom de ce client. Notez que le chemin d’accès du fichier ne requiert pas de guillemets, même s’il contient des espaces.
L’inscription de la chaîne de nom complet de cette manière permet d’utiliser la même inscription pour plusieurs langues. Chaque installation de langue fournit un fichier de ressources différent avec le nom complet stocké au même ID de ressource.
L’exemple suivant illustre l’inscription d’un programme de messagerie instantanée éclairé. Étant donné qu’il s’agit d’un programme de messagerie instantanée, la sous-clé CanonicalName (dans ce cas, lit la vue) est stockée sous la sous-clé im .
HKEY_LOCAL_MACHINE
Software
Clients
IM
Lit View
(Default) = Lit View
LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
Notez l’utilisation de l’entrée (par défaut) comme déclaration secondaire du nom complet du client. Si le LocalizedString n’est pas présent, la valeur (par défaut) est utilisée à la place. Cela fonctionne avec tous les types de clients (navigateurs Internet, navigateurs de messagerie, messagerie instantanée et lecteurs multimédias). Pour assurer la compatibilité descendante avec la disposition du Registre du client Internet Explorer, les programmes de messagerie doivent définir la valeur (par défaut) de la sous-clé CanonicalName sur le nom d’affichage du client dans la langue actuellement installée.
Inscription de l’icône d’un programme
Notes
cette section ne s’applique pas à Windows 2000.
par défaut, la section supérieure du menu démarrer de Windows XP et Windows Vista contient des icônes Internet et de messagerie . ces icônes ne sont pas présentes dans Windows 7 et versions ultérieures. Pour les clients de messagerie et de navigateur, lorsqu’un programme est attribué par défaut à son type de client, l’icône inscrite de ce programme s’affiche pour ces entrées de menu Démarrer .
L’inscription de l’icône d’un programme est obligatoire pour les clients de messagerie et de navigateur. l’inscription d’une icône pour la lecture du média, la messagerie instantanée ou la machine virtuelle pour les types de clients Java est facultative, et les icônes inscrites pour ces types de clients ne sont pas utilisées actuellement par Windows et ne sont pas affichées dans la section supérieure des menus démarrer Windows XP ou Windows Vista.
Pour inscrire une icône pour un programme client, ajoutez une sous-clé DefaultIcon avec une valeur par défaut, comme indiqué ici.
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
CanonicalName
DefaultIcon
(Default) = FilePath,IconIndex
La valeur filePath est le chemin d’accès complet au fichier qui contient l’icône. Ce chemin d’accès ne requiert pas de guillemets, même s’il contient des espaces.
La valeur IndexIcône est interprétée comme suit :
- Si IndexIcône est un nombre positif, le nombre est utilisé comme index du tableau de base zéro des icônes stockées dans le fichier. Par exemple, si IndexIcône est 1, la deuxième icône est chargée à partir du fichier.
- Si IndexIcône est un nombre négatif, la valeur absolue de IndexIcône est utilisée comme identificateur de ressource (plutôt que l’index) pour l’icône. Par exemple, si IndexIcône est-3, l’icône dont l’identificateur de ressource est 3 est chargée à partir du fichier.
L’exemple suivant illustre l’inscription d’un navigateur d’affichage lit hypothétique. La deuxième icône stockée dans le fichier Litview.exe est utilisée comme valeur par défaut.
HKEY_LOCAL_MACHINE
Software
Clients
StartMenuInternet
LITVIEW.EXE
DefaultIcon
(Default) = C:\Program Files\LitwareInc\Litview.exe,1
Inscription d’un verbe ouvert
Notes
cette section ne s’applique pas à Windows 2000. L’étape suivante est nécessaire uniquement pour les clients de messagerie et de navigateur.
Supposons qu’un utilisateur a sélectionné votre programme comme programme Internet ou de messagerie par défaut. cet utilisateur clique sur l’icône Internet ou courrier électronique dans le menu démarrer de Windows XP ou Windows Vista pour ouvrir le programme. À ce stade, la ligne de commande enregistrée comme indiqué ici est exécutée.
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
CanonicalName
shell
open
command
(Default) = command line
La ligne de commande doit spécifier un chemin d’accès absolu complet au fichier, suivi d’options de ligne de commande facultatives. Si le type d’entrée est REG _ expand _ SZ, les variables d’environnement peuvent être utilisées dans le chemin d’accès. Utilisez des guillemets pour vous assurer que les espaces dans la ligne de commande ne sont pas interprétés de manière incorrecte. La ligne de commande doit exécuter le programme avec les valeurs par défaut appropriées. Les navigateurs sont généralement par défaut sur la page d’hébergement de l’utilisateur. Les programmes de messagerie ouvrent généralement la boîte de réception de l’utilisateur.
L’exemple suivant illustre l’inscription d’un open verbe pour un Explorateur d’affichages hypothétique. Elle ne spécifie aucune option de ligne de commande.
HKEY_LOCAL_MACHINE
Software
Clients
StartMenuInternet
LITVIEW.EXE
shell
open
command
(Default) = "C:\Program Files\LitwareInc\Litview.exe"
Notez que, dans cette valeur, des guillemets sont placés autour du chemin d’accès, car il contient des espaces incorporés. Si vous omettez ces guillemets, la ligne de commande risque d’être interprétée à tort.
Inscription des informations d’installation
Notes
cette section ne s’applique pas à Windows Server 2003.
- Commande de réinstallation
- Commande masquer les icônes
- Commande Afficher les icônes
- Configuration du programme de groupe
- Exemple d’inscription de navigateur
La fonctionnalité par laquelle l’utilisateur sélectionne les programmes par défaut par ordinateur est nommée et accessible comme indiqué dans le tableau suivant. (Windows Vista a introduit une nouvelle fonctionnalité, défini vos programmes par défaut, par lequel un utilisateur peut définir des valeurs par défaut par utilisateur.)
| Système d’exploitation | Titre | Emplacement d’accès |
|---|---|---|
| Windows 7 | Définir les paramètres par défaut de l’accès aux programmes et de l’ordinateur |
|
| Windows Vista | Définir les paramètres par défaut de l’accès aux programmes et de l’ordinateur |
|
| Windows XP SP2 | Définir l’accès aux programmes et les valeurs par défaut |
|
| Windows XP SP1 | Configurer des programmes |
|
par souci de simplicité, cette rubrique utilise le titre Windows 7 de la fonctionnalité. Toutes les versions de la fonctionnalité sont communément appelées SPAD.
Notes
si vous exécutez Windows 2000 ou Windows xp, vous devez disposer d’au moins Windows 2000 SP3 ou Windows xp SP1 pour voir la page définir l’accès aux programmes et aux valeurs par défaut . dans Windows Vista et versions ultérieures, l’accès à la page définir les paramètres par défaut de l’accès aux programmes et des ordinateurs requiert des privilèges d’administrateur. Pour cette raison, les développeurs sont encouragés à s’inscrire pour l’élément définir votre panneau de configuration programmes par défaut afin que n’importe quel utilisateur puisse gérer les valeurs par défaut de l’application.
L’arborescence de Registre suivante affiche la variété des informations qui doivent être inscrites dans la clé InstallInfo du programme pour que le programme s’affiche sur la page définir les paramètres par défaut de l’accès aux programmes et de l’ordinateur en tant qu’option pour son type de client. Chacune de ces valeurs est décrite en détail dans les sections suivantes.
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
CanonicalName
InstallInfo
HideIconsCommand = command line
ReinstallCommand = command line
ShowIconsCommand = command line
IconsVisible = 1
La ligne de commande doit spécifier un chemin d’accès absolu complet au fichier, suivi d’options de ligne de commande facultatives. Utilisez des guillemets pour vous assurer que les espaces dans la ligne de commande ne sont pas interprétés de manière incorrecte.
Commande de réinstallation
La ligne de commande de réinstallation déclarée dans la valeur ReinstallCommand est exécutée lorsque l’utilisateur utilise la page définir les paramètres par défaut de l’accès aux programmes et des ordinateurs pour sélectionner votre programme comme type de client par défaut. dans Windows Vista et versions ultérieures, l’accès à cette page nécessite un niveau de privilège d’administrateur. dans Windows 8, si vous avez inscrit votre application en utilisant le même nom pour définir l’accès aux programmes et les paramètres par défaut de l’ordinateur et par défaut, les valeurs par défaut spécifiées dans programmes par défaut pour cette application seront appliquées à l’utilisateur actuel, ainsi que l’exécution de la commande réinstaller.
Le programme lancé par la ligne de commande de réinstallation doit associer l’application à l’ensemble complet de types de fichiers et de protocoles que l’application peut gérer. Toutes les applications doivent mettre en place une fonctionnalité de gestionnaire dans la commande de réinstallation. Les applications peuvent utiliser la commande réinstaller pour inscrire la fonctionnalité et éventuellement établir l’État par défaut. Quand une application choisit d’implémenter les fonctionnalités et l’état du gestionnaire par défaut dans la commande de réinstallation, elle doit également rétablir les liens ou les raccourcis visibles souhaités. Les points d’entrée visibles pour la plupart des applications sont répertoriés dans la commande masquer les icônes.
Notes
Il est vivement recommandé que les applications implémentent la fonctionnalité de gestion dans la commande de réinstallation.
Une fois le processus de réinstallation terminé, le programme lancé par la ligne de commande de réinstallation doit s’arrêter. Il ne doit pas lancer le programme correspondant. il doit simplement enregistrer les valeurs par défaut. Par exemple, la commande de réinstallation d’un navigateur ne doit pas ouvrir la page d’hébergement de l’utilisateur.
Notes
pour les clients de messagerie et de navigateur dans Windows XP et Windows Vista, les applications qui choisissent d’établir la capacité de gestion et l’état par défaut dans la commande de réinstallation doivent s’inscrire à l’icône correspondante en haut du menu Démarrer. Pour plus d’informations, consultez enregistrement du menu Démarrer .
Commande masquer les icônes
La ligne de commande déclarée dans la valeur HideIconsCommand est exécutée lorsque l’utilisateur désactive l’option activer l’accès à ce programme dans la page définir les paramètres par défaut de l’accès aux programmes et de l’ordinateur. Cette ligne de commande doit masquer tous les points d’accès de votre programme qui sont visibles dans l’interface utilisateur. Les instructions spécifiques sont de supprimer des raccourcis et des icônes à partir des emplacements suivants :
- Icônes de bureau
- liens menu Démarrer, y compris le groupe de démarrage
- Liens vers la barre de lancement rapide
- Zone Notifications
- Menus contextuels
- Bande de tâches du dossier
Cette ligne de commande doit également empêcher les appels automatiques du programme, tels que ceux spécifiés dans la clé de Registre Run . Les fournisseurs sont encouragés à implémenter ces instructions dans le rappel d’accès de masquage de l’application.
Vous n’avez pas besoin d’abandonner l’inscription (fonctionnalité d’application) des types de fichiers lorsque les icônes sont masquées. Vous n’avez pas non plus besoin de renoncer à l’État par défaut de l’application pour les types de fichiers et de protocoles. Cela peut entraîner une mauvaise expérience utilisateur lorsque ces types sont rencontrés dans l’interface utilisateur.
Après avoir masqué correctement les icônes, vous devez mettre à jour la valeur de Registre IconsVisible sur 0 comme indiqué ci-dessous :
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
CanonicalName
InstallInfo
IconsVisible = 0
L’entrée IconsVisible est de type reg _ DWORD.
Une autre méthode masquer les icônes dans SPAD
Pour certaines applications héritées, une implémentation complète de l’accès masqué peut ne pas être pratique. Une autre méthode qui atteint le même effet consiste à désinstaller l’application. La section ci-dessous montre un exemple de comportement et un exemple de code pour implémenter cette alternative. En général, les éditeurs de logiciels indépendants doivent éviter cette alternative, car ils :
- Désinstallez complètement l’application du système.
- Supprimer les valeurs par défaut précédemment sélectionnées.
- Ne laissez aucune option d’interface utilisateur pour réinstaller l’application.
- Rendez la fonctionnalité activer l’accès plus disponible, car une désinstallation supprime complètement l’application de SPAD.
L’expérience utilisateur recommandée est la suivante :
Lorsque l’utilisateur décoche la case activer l’accès à ce programme dans SPAD, l’interface utilisateur suivante est présentée.

Quand l’utilisateur clique sur OK, l’élément programmes et fonctionnalités du panneau de configuration démarre pour permettre à l’utilisateur de désinstaller l’application.
Windows Les utilisateurs XP doivent être affichés dans cette boîte de dialogue.

lorsque l’utilisateur Windows XP sélectionne OK, l’élément ajouter ou supprimer des programmes du panneau de configuration démarre pour permettre à l’utilisateur de désinstaller l’application.
Le code suivant fournit une implémentation réutilisable pour la fonctionnalité masquer l’accès, comme indiqué ci-dessus. il peut être utilisé sur Windows XP, Windows Vista et Windows 7.
#include <windows.h>
#include <shlwapi.h>
#include <strsafe.h>
PCWSTR c_pszMessage1 = L"To hide access to this program, you need to uninstall it by ";
PCWSTR c_pszMessage2 = L"using\n%s in Control Panel.\n\nWould you like to start %s?";
PCWSTR c_pszApplicationName = L"Sample App";
int _tmain(int argc, WCHAR* argv[])
{
OSVERSIONINFO version;
version.dwOSVersionInfoSize = sizeof(version);
if (GetVersionEx(&version))
{
PCWSTR pszCPLName = NULL;
if (version.dwMajorVersion >= 6)
{
// Windows Vista and later
pszCPLName = L"Programs and Features";
}
else if (version.dwMajorVersion == 5 &&
version.dwMinorVersion == 1)
{
// Windows XP
pszCPLName = L"Add/Remove Programs";
}
if (pszCPLName != NULL)
{
WCHAR szMessage[256], szScratch[256];
if (SUCCEEDED(StringCchPrintf(szScratch,
ARRAYSIZE(szScratch),
c_pszMessage2,
pszCPLName,
pszCPLName)))
{
if (SUCCEEDED(StringCchCopy(szMessage,
ARRAYSIZE(szMessage),
c_pszMessage1)))
{
if (SUCCEEDED(StringCchCat(szMessage,
ARRAYSIZE(szMessage),
szScratch)))
{
if (IDOK == MessageBox(NULL,
szMessage,
c_pszApplicationName,
MB_OKCANCEL))
{
ShellExecute(NULL,
NULL,
L"appwiz.cpl",
NULL,
NULL,
SW_SHOWNORMAL);
}
}
}
}
}
}
return 0;
}
Commande Afficher les icônes
La ligne de commande déclarée dans l’entrée ShowIconsCommand est exécutée lorsque l’utilisateur coche la case activer l’accès à ce programme dans la page définir les paramètres par défaut de l’accès aux programmes et de l’ordinateur. Cette ligne de commande peut restaurer les points d’accès de votre programme, y compris ceux qui se trouvent dans le menu Démarrer , sur le bureau et dans le groupe démarrage , ainsi que les appels automatiques normaux, tels que ceux spécifiés dans la clé de Registre Run . Les points d’accès visibles intéressants pour la plupart des applications sont répertoriés dans la commande masquer les icônes. L’application ne doit pas modifier les valeurs par défaut par utilisateur ; Cette modification doit être effectuée par l’utilisateur par le biais de programmes par défaut.
Une fois vos icônes correctement affichées, vous devez mettre à jour la valeur de Registre IconsVisible sur 1, comme indiqué ci-dessous :
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
CanonicalName
InstallInfo
IconsVisible = 1
Notez que si vous avez utilisé l’entrée HideIconsCommand pour inviter une désinstallation de l’application, l’entrée ShowIconsCommand n’est pas utilisée. Elle doit être supprimée du Registre avec le reste des informations de l’application pendant le processus de désinstallation.
Configuration du programme de groupe
Notes
cette section ne s’applique pas à Windows 2000.
Dans le cadre de la préparation du système, un fabricant d’ordinateurs OEM peut établir une configuration qui masque les points d’accès pour les programmes du navigateur, de la messagerie, de la lecture multimédia, de la messagerie instantanée ou de la machine virtuelle Microsoft pour les programmes clients Java et spécifie leurs propres programmes par défaut. Les fabricants OEM peuvent permettre aux utilisateurs de réinitialiser leurs ordinateurs à tout moment dans cette configuration par défaut en définissant les valeurs de Registre suivantes.
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
CanonicalName
InstallInfo
OEMShowIcons = 1
OEMDefault = 1
Si ces clés sont définies, les utilisateurs peuvent restaurer la configuration OEM en sélectionnant l’option fabricant de l' ordinateur dans la page définir les paramètres par défaut de l’accès aux programmes et de l’ordinateur. Si ces clés ne sont pas définies, l’option fabricant de l' ordinateur n’est pas affichée.
L’entrée OEMShowIcons , si elle est présente, définit l’état de l’icône afficher pour le client spécifié qui est appliqué si l’utilisateur sélectionne fabricant de l' ordinateur. La valeur 1 entraîne l’affichage des icônes, tandis que la valeur 0 provoque l’absence d’affichage des icônes. Si OEMShowIcons est absent, le fait de sélectionner le fabricant de l' ordinateur n’a aucun effet sur l’icône Afficher le paramètre. OEMShowIcons est de type reg _ DWORD.
L’entrée OEMDefault , si elle est présente et définie sur 1, définit la préférence OEM pour le client par défaut du type indiqué. Un seul client d’un type particulier peut être marqué comme valeur par défaut OEM. Si plus d’une inscription du client contient l’entrée OEMDefault , tous sont ignorés et le client actuel continue à être utilisé comme client par défaut. Si l’entrée OEMDefault est absente ou présente et définie sur 0, ce client particulier n’est pas utilisé comme client par défaut si l’utilisateur sélectionne Computer Manufacturer. OEMDefault est de type reg _ DWORD.
Outre l’option de réinitialisation de leurs ordinateurs à la configuration par défaut établie par l’OEM, les utilisateurs disposent de trois autres options de configuration :
- définissez l’ordinateur sur une configuration Microsoft Windows. Dans ce cas, la page définir les paramètres par défaut de l’accès aux programmes et de l’ordinateur permet d’accéder à tous les logiciels Microsoft et non-Microsoft sur l’ordinateur inscrit dans les catégories de produits appropriées. les programmes Microsoft Windows sont sélectionnés comme option par défaut pour chaque catégorie.
- Définissez leur ordinateur sur une configuration non-Microsoft. cette configuration masque les points d’accès (tels que le menu démarrer ) à Windows Internet Explorer, Lecteur Windows Media, Windows Messenger et Microsoft Outlook Express. Il permet d’accéder aux logiciels non-Microsoft sur l’ordinateur dans ces catégories. En outre, si un programme non-Microsoft est disponible dans une catégorie, il est défini comme valeur par défaut pour cette catégorie. Si plusieurs programmes non-Microsoft sont disponibles dans une catégorie, l’utilisateur est invité à choisir le programme non-Microsoft qui doit être utilisé par défaut.
- Établissez une configuration personnalisée. Les utilisateurs effectuent leurs propres sélections pour l’activation ou la suppression de l’accès, en mélangeant les programmes Microsoft et non-Microsoft comme ils le voient. Les utilisateurs établissent des options par défaut en fonction de la catégorie.
Les utilisateurs sont libres de modifier ces options à tout moment.
Exemple d’inscription de navigateur
L’exemple suivant montre l’inscription InstallInfo complète pour un navigateur de vue éclairé de façon fictive. Dans ce cas, les commutateurs de ligne de commande permettent au fichier Litview.exe d’effectuer toutes les actions nécessaires pour chaque valeur.
HKEY_LOCAL_MACHINE
Software
Clients
StartMenuInternet
LITVIEW.EXE
InstallInfo
ReinstallCommand = "C:\Program Files\LitwareInc\Litview.exe" /reinstall
HideIconsCommand = "C:\Program Files\LitwareInc\Litview.exe" /hideicons
ShowIconsCommand = "C:\Program Files\LitwareInc\Litview.exe" /showicons
IconsVisible = 1
Notez que les guillemets sont placés autour des tracés, car ils contiennent des espaces incorporés.
Éléments d’inscription pour des types de client spécifiques
Vous trouverez également les informations suivantes dans les ressources figurant dans la section Rubriques connexes à la fin de cette rubrique.
Enregistrement du menu Démarrer
sous Windows XP, les applications sont généralement inscrites par défaut sur un ordinateur (hkey _ LOCAL _ machine) plutôt que sur l’étendue utilisateur (hkey _ CURRENT _ user). avec l’introduction Windows Vista du contrôle de compte d’utilisateur, les applications qui réclament l' Internet et les emplacements de messagerie dans le menu démarrer doivent implémenter la commande de réinstallation dans le contexte d’exécution approprié.
Notes
le lien menu Démarrer E-mail a été supprimé à partir de Windows 7. Toutefois, l’inscription décrite dans cette section doit toujours être effectuée, car elle affecte le client MAPI par défaut.
un utilisateur limité sur Windows XP, Windows Vista ou Windows 7 ne peut pas accéder à SPAD. Pour cette raison, les développeurs sont encouragés à s’inscrire à l’élément définir vos programmes par défaut du panneau de configuration afin que n’importe quel utilisateur puisse gérer les valeurs par défaut des applications par utilisateur.
Les sélections effectuées dans SPAD doivent uniquement affecter les paramètres par ordinateur.
Définissez la valeur de Registre comme suit.
HKEY_LOCAL_MACHINE
Software
Clients
ClientTypeName
(Default) = CanonicalName
Notes
les informations suivantes s’appliquent uniquement à Windows XP.
Si l’inscription de la valeur par défaut au niveau de l’ordinateur sous HKEY _ local _ machine comme indiqué ci-dessus est réussie, l’application doit supprimer la valeur assignée à l’entrée par défaut sous la sous-clé suivante :
HKEY_CURRENT_USER
SOFTWARE
Clients
ClientTypeName
Si l’inscription de la valeur par défaut au niveau de l’ordinateur sous HKEY _ local _ machine comme indiqué ci-dessus échoue, généralement parce que l’utilisateur n’a pas d’autorisation d’écriture sur la sous-clé, l’application doit définir la valeur suivante :
HKEY_CURRENT_USER
SOFTWARE
Clients
ClientTypeName
(Default) = CanonicalName
Cela enregistre le nom canonique uniquement pour l’utilisateur actuel, et non pour tous les utilisateurs.
Après la mise à jour des clés de Registre, le programme doit diffuser le message WM _ SETTINGCHANGE avec wParam = 0 et lParam pointant vers la chaîne terminée par le caractère null « \ clients logiciels \ ClientTypeName» pour notifier le système d’exploitation que le client par défaut a changé.
Inscription du client de messagerie
Pour un client de messagerie, le programme doit avoir des paramètres enregistrés sous la clé de clé mailto de la _ _ racine de classes HKEY \ pour pouvoir traiter les URL qui utilisent le mailto protocole. Définissez les valeurs et les clés qui reflètent ces paramètres sous la clé suivante.
HKEY_LOCAL_MACHINE
Software
Clients
Mail
CanonicalName
Protocols
mailto
Cette hiérarchie de Registre remplace la mailto hiérarchie de Registre existante trouvée dans HKEY _ classes _ root \ mailto. La hiérarchie reste la même, seul l’emplacement a changé. Le format de cette hiérarchie est documenté sur MSDN sous vues d’ensemble et didacticiels de protocoles enfichables asynchrones. En règle générale, le mailto protocole est inscrit à un programme plutôt qu’à un protocole asynchrone, auquel cas la documentation sur l' enregistrement d’une application dans un schéma d’URI s’applique.
L’exemple suivant illustre la mailto section de l’inscription d’un mailto Gestionnaire inscrit auprès d’un programme.
HKEY_LOCAL_MACHINE
Software
Clients
Mail
CanonicalName
Protocols
mailto
(Default) = URL:MailTo Protocol
EditFlags = 02 00 00 00
URL Protocol
DefaultIcon
(Default) = %FilePath%,IconIndex
shell
open
command
(Default) = command line
La valeur de Registre indicateurs est documentée dans les types de fichiers de la section intitulée « définition des attributs de type de fichier ».
Compléter les exemples d’inscriptions
Les exemples suivants sont fournis pour montrer les exigences d’inscription complètes pour les différents types de clients.
- Exemple de navigateur
- Exemple de navigateur de messagerie
- Exemple de lecteur multimédia
- Exemple de programme Instant Messenger
- Exemple de machine virtuelle Java
Exemple de navigateur
HKEY_LOCAL_MACHINE
Software
Clients
StartMenuInternet
LITVIEW.EXE
(Default) = Lit View
LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
DefaultIcon
(Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
InstallInfo
ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
IconsVisible = 1
shell
open
command
(Default) = "C:\Program Files\LitwareInc\LITVIEW.EXE" /homepage
Exemple de navigateur de messagerie
HKEY_LOCAL_MACHINE
Software
Clients
Mail
Lit View
(Default) = Lit View
DLLPath = @C:\Program Files\LItwareInc\LitwareMAPI.dll
LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
DefaultIcon
(Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
InstallInfo
ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
IconsVisible = 1
shell
open
command
(Default) = "C:\Program Files\LitwareInc\LITVIEW.EXE" /inbox
protocols
mailto
(Default) = URL:MailTo Protocol
EditFlags = 02 00 00 00
URL Protocol
DefaultIcon
(Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
shell
open
command
(Default) = "C:\Program Files\LitwareInc\LITVIEW.EXE" /mailto:%1
Exemple de lecteur multimédia
HKEY_LOCAL_MACHINE
Software
Clients
Media
Lit View
(Default) = Lit View
LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
DefaultIcon
(Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
InstallInfo
ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
IconsVisible = 1
Exemple de programme Instant Messenger
HKEY_LOCAL_MACHINE
Software
Clients
IM
Lit View
(Default) = Lit View
LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
DefaultIcon
(Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
InstallInfo
ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
IconsVisible = 1
Exemple de machine virtuelle Java
HKEY_LOCAL_MACHINE
Software
Clients
JavaVM
Lit View
(Default) = Lit View
LocalizedString = @C:\Program Files\LitwareInc\ResourceDLL.dll,-123
DefaultIcon
(Default) = C:\Program Files\LitwareInc\LITVIEW.EXE,1
InstallInfo
ReinstallCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /reinstall
HideIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /hideicons
ShowIconsCommand = "C:\Program Files\LitwareInc\LITVIEW.EXE" /showicons
IconsVisible = 1
Les exemples de sociétés, d’organisations, de produits, de noms de domaine, d’adresses de messagerie, de logos, de personnes, de lieux et d’événements mentionnés dans les exemples sont fictifs. Toute ressemblance avec des sociétés, des organisations, des produits, des noms de domaine, des adresses électroniques, des logos, des personnes, des lieux ou des événements réels est purement fortuite et involontaire.