Estrutura NEWCPLINFOA (cpl.h)

  • Artigo

Contém informações de recurso e um valor definido pelo aplicativo para uma caixa de diálogo compatível com um aplicativo Painel de Controle.

Sintaxe

typedef struct tagNEWCPLINFOA {
  DWORD    dwSize;
  DWORD    dwFlags;
  DWORD    dwHelpContext;
  LONG_PTR lData;
  HICON    hIcon;
  CHAR     szName[32];
  CHAR     szInfo[64];
  CHAR     szHelpFile[128];
} NEWCPLINFOA, *LPNEWCPLINFOA;

Membros

dwSize

Tipo: DWORD

O comprimento da estrutura, em bytes.

dwFlags

Tipo: DWORD

Esse membro é ignorado.

dwHelpContext

Tipo: DWORD

Esse membro é ignorado.

lData

Tipo: LONG_PTR

Um ponteiro para os dados definidos pelo aplicativo. Quando o Painel de Controle envia as mensagens CPL_DBLCLK e CPL_STOP, ele passa esse valor de volta para seu aplicativo.

hIcon

Tipo: HICON

O identificador do ícone que representa a caixa de diálogo. Este ícone destina-se a ser exibido pelo aplicativo que controla o aplicativo Painel de Controle.

szName[32]

Tipo: TCHAR[32]

Uma cadeia de caracteres terminada em nulo que contém o nome da caixa de diálogo. O nome deve ser exibido abaixo do ícone.

szInfo[64]

Tipo: TCHAR[64]

Uma cadeia de caracteres terminada em nulo que contém a descrição da caixa de diálogo. A descrição deve ser exibida quando o ícone da caixa de diálogo é selecionado.

szHelpFile[128]

Tipo: TCHAR[128]

Esse membro é ignorado.

Comentários

A função CPlApplet do aplicativo Painel de Controle retorna essas informações ao Painel de Controle em resposta a uma mensagem CPL_NEWINQUIRE.

Observação

O cabeçalho cpl.h define NEWCPLINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho cpl.h

Confira também

CPLINFO