CPL_INQUIRE message

Envoyé à la fonction CPlApplet d’une application Panneau de configuration pour demander des informations sur une boîte de dialogue prise en charge par l’application.

Paramètres

uAppNum

Numéro de la boîte de dialogue. Ce nombre doit être compris entre zéro et un inférieur à la valeur retourné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 court, la description et toute valeur définie par l’utilisateur associée à la boîte de dialogue.

Valeur retournée

Si la fonction CPlApplet traite correctement ce message, elle doit retourner zéro.

Notes

Le Panneau de configuration envoie le message CPL_INQUIRE une fois pour chaque boîte de dialogue prise en charge par votre application. Le Panneau de configuration envoie également un message CPL_NEWINQUIRE 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 CPL_INQUIRE et CPL_NEWINQUIRE sont envoyés.

Vous pouvez effectuer l’initialisation de la boîte de dialogue lorsque vous recevez CPL_INQUIRE. Si vous devez allouer de la mémoire, faites-le en réponse au message CPL_INIT .

Le message CPL_NEWINQUIRE retourne des informations sous une forme que le système ne peut pas mettre en cache. Pour cette raison, la plupart des fonctions CPlApplet doivent traiter CPL_INQUIRE et ignorer CPL_NEWINQUIRE.

Les seules applications qui doivent utiliser CPL_NEWINQUIRE sont celles qui doivent modifier leur icône ou afficher des chaînes en fonction de l’état de l’ordinateur. Dans ce cas, votre gestionnaire de CPL_INQUIRE doit spécifier la valeur CPL_DYNAMIC_RES pour les membres idIcon, idName ou idInfo de la structure CPLINFO , au lieu de spécifier un identificateur de ressource valide. Ainsi, le Panneau de configuration envoie le message CPL_NEWINQUIRE 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 l’utilisation d’informations mises en cache.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Cpl.h