Compartir a través de

mensaje de CPL_NEWINQUIRE

  • Artículo

Se envía a la función CPlApplet de una aplicación de Panel de control para solicitar información sobre un cuadro de diálogo que admite la aplicación.

Parámetros

uAppNum

Número del cuadro de diálogo. Este número debe estar en el intervalo cero a uno menor que el valor devuelto en respuesta al mensaje CPL_GETCOUNT (CPL_GETCOUNT – 1).

lpncpli

Dirección de una estructura NEWCPLINFO . La aplicación Panel de control debe rellenar esta estructura con información sobre el cuadro de diálogo.

Valor devuelto

Si la función CPlApplet procesa correctamente este mensaje, debe devolver cero.

Observaciones

Para mejorar el rendimiento, la mayoría de las aplicaciones deben ignorar CPL_NEWINQUIRE y procesar el mensaje CPL_INQUIRE en su lugar.

El Panel de control envía el mensaje CPL_NEWINQUIRE una vez para cada cuadro de diálogo admitido por la aplicación. El Panel de control también envía un mensaje CPL_INQUIRE para cada cuadro de diálogo. Estos mensajes se envían inmediatamente después del mensaje de CPL_GETCOUNT . Sin embargo, el sistema no garantiza el orden en que se envían los mensajes CPL_INQUIRE y CPL_NEWINQUIRE .

Puede realizar la inicialización para el cuadro de diálogo cuando reciba CPL_INQUIRE. Si debe asignar memoria, hágalo en respuesta al mensaje CPL_INIT .

CPL_INQUIRE es el mensaje preferido. Esto se debe a que CPL_NEWINQUIRE devuelve información en un formulario que el sistema no puede almacenar en caché. Por lo tanto, las aplicaciones que procesan CPL_NEWINQUIRE deben cargarse cada vez que el Panel de control necesita la información, lo que da lugar a una reducción significativa del rendimiento.

Las únicas aplicaciones que deben usar CPL_NEWINQUIRE son las que necesitan cambiar su icono o cadenas de visualización en función del estado del equipo. En este caso, el controlador de CPL_INQUIRE debe especificar el valor de CPL_DYNAMIC_RES para los miembros idIcon, idName o idInfo de la estructura CPLINFO , en lugar de especificar un identificador de recurso válido. Esto hace que el Panel de control envíe el mensaje CPL_NEWINQUIRE cada vez que necesite el icono y las cadenas de visualización, lo que le permite especificar información basada en el estado actual del equipo. Por supuesto, esto es significativamente más lento que el uso de información almacenada en caché.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Cpl.h