_Message NEWINQUIRE 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).

lpncpli

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

Valeur de retour

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 de _ recherche de cpl à la place.

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

Cpl _ L’interrogation est le message par défaut. Cela est dû au fait que Cpl _ NEWINQUIRE retourne des informations dans un format que le système ne peut pas mettre en cache. Par conséquent, les applications qui traitent le tableau de bord _ NEWINQUIRE doivent être chargées chaque fois que le panneau de configuration a besoin des informations, ce qui réduit considérablement les performances.

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. Bien entendu, 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