CPL_NEWINQUIRE 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 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).

lpncpli

Adresse d’une structure NEWCPLINFO . L’application Panneau de configuration doit remplir cette structure avec des informations sur la boîte de dialogue.

Valeur retournée

Si la fonction CPlApplet traite ce message avec succès, elle doit retourner zéro.

Notes

Pour de meilleures performances, la plupart des applications doivent ignorer CPL_NEWINQUIRE et traiter le message CPL_INQUIRE à la place.

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

CPL_INQUIRE est le message préféré. En effet , CPL_NEWINQUIRE retourne des informations sous une forme que le système ne peut pas mettre en cache. Par conséquent, les applications qui traitent CPL_NEWINQUIRE doivent être chargées chaque fois que le Panneau de configuration a besoin des informations, ce qui entraîne une réduction significative des performances.

Les seules applications qui doivent utiliser CPL_NEWINQUIRE sont celles qui doivent modifier leur icône ou leurs chaînes d’affichage 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 , plutôt que 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. Bien sûr, 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