Condividi tramite

Struttura NEWCPLINFOA (cpl.h)

  • Articolo

Contiene informazioni sulle risorse e un valore definito dall'applicazione per una finestra di dialogo supportata da un'applicazione Pannello di controllo.

Sintassi

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;

Membri

dwSize

Tipo: DWORD

Lunghezza della struttura, espressa in byte.

dwFlags

Tipo: DWORD

Questo membro viene ignorato.

dwHelpContext

Tipo: DWORD

Questo membro viene ignorato.

lData

Tipo: LONG_PTR

Puntatore ai dati definiti dall'applicazione. Quando il Pannello di controllo invia i messaggi CPL_DBLCLK e CPL_STOP, passa questo valore all'applicazione.

hIcon

Tipo: hicon

Identificatore dell'icona che rappresenta la finestra di dialogo. Questa icona deve essere visualizzata dall'applicazione che controlla l'applicazione Pannello di controllo.

szName[32]

Tipo: TCHAR[32]

Stringa con terminazione Null contenente il nome della finestra di dialogo. Il nome deve essere visualizzato sotto l'icona.

szInfo[64]

Tipo: TCHAR[64]

Stringa con terminazione Null contenente la descrizione della finestra di dialogo. La descrizione deve essere visualizzata quando è selezionata l'icona per la finestra di dialogo.

szHelpFile[128]

Tipo: TCHAR[128]

Questo membro viene ignorato.

Osservazioni

La funzione CPlApplet dell'applicazione Pannello di controllo restituisce queste informazioni al Pannello di controllo in risposta a un messaggio di CPL_NEWINQUIRE.

Nota

L'intestazione cpl.h definisce NEWCPLINFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows XP [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
intestazione cpl.h

Vedere anche

CPLINFO