Partager via

Ajout de valeurs de Registre pour un objet Notify

  • Article

Un composant NetTrans, NetClient ou NetService peut avoir un objet de notification qui effectue une ou plusieurs des actions suivantes :

  • Affiche une interface utilisateur pour le composant

  • Avertit le composant des événements de liaison afin que le composant puisse exercer un certain contrôle sur le processus de liaison

  • Installe ou supprime de manière conditionnelle les composants logiciels

Remarque Les composants NetClient sont dépréciés dans Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

Pour plus d’informations sur les objets de notification, consultez Notifier les objets pour les composants réseau.

Remarque Les composants Net (adaptateurs) ne prennent pas en charge les objets de notification ; par conséquent, ces composants doivent utiliser un co-programme d’installation.

Pour plus d’informations sur les co-programmes d’installation, consultez Écriture d’un co-programme d’installation.

Si un composant a un objet notify, le fichier INF de ce composant doit ajouter (via une section add-registry) les valeurs suivantes à la clé Ndi du composant :

Clsid
Valeur REG_SZ qui spécifie le GUID (identificateur global unique) de l’objet de notification. Obtenez ce GUID en exécutant l’utilitaire uuidgen.exe. Pour plus d’informations sur cet utilitaire, consultez la Microsoft Windows SDK.

ComponentDll
Valeur REG_SZ qui spécifie le chemin d’accès à la DLL de l’objet de notification. ComponentDll doit spécifier le chemin d’accès complet à la DLL si la DLL ne se trouve pas dans le répertoire Windows\System32.

Voici un exemple d’add-registry-section qui ajoute des valeurs ClsID et ComponentDll à la clé Ndi :

[MS_Protocol.ndi.reg]
HKR, Ndi, ClsID, 0, "GUID"
HKR, Ndi, ComponentDll, 0, "notifyobject.dll"

La section DDInstall d’un composant qui a un objet notify doit également contenir une directive CopyFiles qui fait référence à une section file-list qui copie la DLL de l’objet de notification dans le répertoire de destination spécifié par la section DestinationDirs . Pour plus d’informations sur la directive CopyFiles et les sections DestinationDirs , consultez Sections et directives de fichier INF.