CPL_INQUIRE 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 zero a um a menos do que o valor retornado em resposta à mensagem de CPL_GETCOUNT (CPL_GETCOUNT – 1).

lpcpli

O endereço de uma estrutura CPLINFO . O aplicativo deve preencher essa estrutura com identificadores de recurso para o ícone, o nome curto, a descrição e qualquer valor definido pelo usuário associado à caixa de diálogo.

Valor retornado

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

Comentários

O Painel de Controle envia a mensagem CPL_INQUIRE uma vez para cada caixa de diálogo compatível com seu aplicativo. O Painel de Controle também envia uma mensagem CPL_NEWINQUIRE 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 .

A mensagem CPL_NEWINQUIRE retorna informações em um formulário que o sistema não pode armazenar em cache. Por esse motivo, a maioria das funções CPlApplet deve processar CPL_INQUIRE e ignorar CPL_NEWINQUIRE.

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, seu 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 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. Isso é significativamente mais lento do que usar informações armazenadas em cache.

Requisitos