_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
Cpl. h