Compartir a través de

mensaje de CPL_INQUIRE

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

lpcpli

Dirección de una estructura CPLINFO . La aplicación debe rellenar esta estructura con identificadores de recursos para el icono, el nombre corto, la descripción y cualquier valor definido por el usuario asociado al cuadro de diálogo.

Valor devuelto

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

Comentarios

El Panel de control envía el mensaje CPL_INQUIRE una vez para cada cuadro de diálogo admitido por la aplicación. El Panel de control también envía un mensaje de CPL_NEWINQUIRE 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 .

El mensaje CPL_NEWINQUIRE devuelve información en un formulario que el sistema no puede almacenar en caché. Por este motivo, la mayoría de las funciones de CPlApplet deben procesar CPL_INQUIRE e ignorar CPL_NEWINQUIRE.

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