Compartilhar via

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 do 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 o CPL_DBLCLK e CPL_STOP mensagens, 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 for selecionado.

szHelpFile[128]

Tipo: TCHAR[128]

Esse membro é ignorado.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

CPLINFO