CPL_NEWINQUIRE
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Esta mensagem é enviada para um aplicativo Control Panel a solicitação informações sobre uma caixa diálogo que suporta o aplicativo.
Syntax
CPL_NEWINQUIRE uAppNum = (UINT) lParam1;
lpncpli = (LPNEWCPLINFO) lParam2;
Parameters
- uAppNum
Número caixa de diálogo. Esse número deve estar no intervalo zero através de um menor do que o valor retornado na resposta para a mensagem CPL_GETCOUNT (CPL_GETCOUNT – 1).
- lpncpli
Ponteiro longo para um NEWCPLINFO estrutura. O aplicativo Control Panel deve preencher essa estrutura com informações sobre caixa de diálogo.
Return Value
Zero indica que o CPlApplet função processa esta mensagem com êxito.
Remarks
O Painel de controle envia a mensagem CPL_NEWINQUIRE uma vez para cada caixa diálogo com suporte, o aplicativo. O Painel de controle também envia uma mensagem CPL_INQUIRE para cada caixa diálogo. Essas mensagens são enviadas imediatamente após a mensagem CPL_GETCOUNT. No entanto, o sistema não garante a ordem em que as mensagens CPL_INQUIRE e CPL_NEWINQUIRE são enviadas.
Você pode executar inicialização para caixa de diálogo quando você receber CPL_INQUIRE. Se você deve alocar memória, faça isso em resposta para a mensagem CPL_INIT.
A mensagem CPL_NEWINQUIRE foi introduzida no versão de Windows 3.1 como uma substituição para CPL_INQUIRE. No entanto, CPL_INQUIRE é a mensagem preferencial para Microsoft Windows 95 e Microsoft Windows NT® versão 4.0. Isso ocorre porque CPL_NEWINQUIRE retorna informações em uma forma que o sistema não é armazenar em cache. Conseqüentemente, os aplicativos que processo CPL_NEWINQUIRE deve ser carregado cada tempo o Painel de controle precisa de informações, resultando em uma redução significativa no desempenho.
Os somente aplicativos que devem usar CPL_NEWINQUIRE são aqueles que precise ícone alteração ou exibir as seqüências de caracteres baseiam o estado do computador. Neste maiúsculas e minúsculas, o manipulador CPL_INQUIRE deve especificar o CPL_DYNAMIC_RES valor para o idIcon, idName, ou idInfo Os membros das CPLINFO estrutura, em vez especificando um válido identificador recurso. Isso faz com que o Painel de controle para enviar a mensagem CPL_NEWINQUIRE cada tempo ele precisa as seqüências de caracteres ícone e exibir, permitindo que você especificar informações baseiam o atual estado do computador. Naturalmente, isso é significativamente mais lento do que usando informações armazenadas em cache.
Requirements
| Header | cpl.h |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Pocket PC 2000 and later |