CPL_NEWINQUIRE mensagem

Enviado para a função CPlApplet de um aplicativo Painel de Controle para solicitar informações sobre uma caixa de diálogo compatível com o aplicativo.

Parâmetros

uAppNum

O número da caixa de diálogo. Esse número deve estar no intervalo de zero a um a menos do que o valor retornado em resposta à mensagem de CPL_GETCOUNT (CPL_GETCOUNT – 1).

lpncpli

O endereço de uma estrutura NEWCPLINFO . O aplicativo Painel de Controle deve preencher essa estrutura com informações sobre a caixa de diálogo.

Valor retornado

Se a função CPlApplet processar essa mensagem com êxito, ela deverá retornar zero.

Comentários

Para melhorar o desempenho, a maioria dos aplicativos deve ignorar CPL_NEWINQUIRE e processar a mensagem de CPL_INQUIRE .

O Painel de Controle envia a mensagem de CPL_NEWINQUIRE uma vez para cada caixa de diálogo compatível com seu aplicativo. O Painel de Controle também envia uma mensagem CPL_INQUIRE para cada caixa de diálogo. Essas mensagens são enviadas imediatamente após a mensagem CPL_GETCOUNT . No entanto, o sistema não garante a ordem na qual as mensagens CPL_INQUIRE e CPL_NEWINQUIRE são enviadas.

Você pode executar a inicialização para a caixa de diálogo quando receber CPL_INQUIRE. Se você precisar alocar memória, faça isso em resposta à mensagem CPL_INIT .

CPL_INQUIRE é a mensagem preferencial. Isso ocorre porque CPL_NEWINQUIRE retorna informações em um formulário que o sistema não pode armazenar em cache. Consequentemente, os aplicativos que processam CPL_NEWINQUIRE devem ser carregados sempre que o Painel de Controle precisar das informações, resultando em uma redução significativa no desempenho.

Os únicos aplicativos que devem usar CPL_NEWINQUIRE são aqueles que precisam alterar o ícone ou exibir cadeias de caracteres com base no estado do computador. Nesse caso, o manipulador de CPL_INQUIRE deve especificar o valor CPL_DYNAMIC_RES para os membros idIcon, idName ou idInfo da estrutura CPLINFO , em vez de especificar um identificador de recurso válido. Isso faz com que o Painel de Controle envie a mensagem de CPL_NEWINQUIRE sempre que precisar do ícone e exibir cadeias de caracteres, permitindo que você especifique informações com base no estado atual do computador. É claro que isso é significativamente mais lento do que usar informações armazenadas em cache.

Requisitos