_Message de recherche cpl
Envoyé à la fonction CPlApplet d’une application du panneau de configuration pour demander des informations sur une boîte de dialogue que l’application prend en charge.
Paramètres
-
uAppNum
-
Numéro de la boîte de dialogue. Ce nombre doit être compris entre zéro et une valeur inférieure à la valeur renvoyée en réponse au message Cpl _ GETCOUNT (CPL _ GetCount – 1).
-
lpcpli
-
Adresse d’une structure CPLINFO . L’application doit remplir cette structure avec des identificateurs de ressource pour l’icône, le nom abrégé, la description et toute valeur définie par l’utilisateur associée à la boîte de dialogue.
Valeur de retour
Si la fonction CPlApplet traite ce message avec succès, elle doit retourner zéro.
Notes
Le panneau de configuration envoie le message de _ recherche Cpl une fois pour chaque boîte de dialogue prise en charge par votre application. Le panneau de configuration envoie également un message _ NEWINQUIRE Cpl pour chaque boîte de dialogue. Ces messages sont envoyés immédiatement après le message Cpl _ GETCOUNT . Toutefois, le système ne garantit pas l’ordre _ dans lequel les messages _ NEWINQUIRE et Cpl sont envoyés.
Vous pouvez procéder à l’initialisation de la boîte de dialogue lorsque vous recevez l' _ enquête Cpl. Si vous devez allouer de la mémoire, faites-le en réponse au message d' _ initialisation de cpl .
Le message _ NEWINQUIRE de cpl retourne des informations dans un format que le système ne peut pas mettre en cache. Pour cette raison, la plupart des fonctions CPlApplet doivent traiter le panneau de _ recherche et ignorer Cpl _ NEWINQUIRE.
Les seules applications qui doivent utiliser Cpl _ NEWINQUIRE sont celles qui ont besoin de modifier leur icône ou d’afficher des chaînes en fonction de l’état de l’ordinateur. Dans ce cas, votre gestionnaire de _ recherche de cpl doit spécifier la _ _ valeur res dynamique CPL pour les membres idIcon, idName ou idInfo de la structure CPLINFO , plutôt que de spécifier un identificateur de ressource valide. Cela amène le panneau de configuration à envoyer le message _ NEWINQUIRE Cpl chaque fois qu’il a besoin de l’icône et des chaînes d’affichage, ce qui vous permet de spécifier des informations en fonction de l’état actuel de l’ordinateur. Cela est beaucoup plus lent que d’utiliser les informations mises en cache.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau XP uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server - [Applications de bureau uniquement] |
| En-tête |
|