Struttura NEWCPLINFOW (cpl.h)

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 tagNEWCPLINFOW {
  DWORD    dwSize;
  DWORD    dwFlags;
  DWORD    dwHelpContext;
  LONG_PTR lData;
  HICON    hIcon;
  WCHAR    szName[32];
  WCHAR    szInfo[64];
  WCHAR    szHelpFile[128];
} NEWCPLINFOW, *LPNEWCPLINFOW;

Members

dwSize

Tipo: DWORD

Lunghezza della struttura, 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 di nuovo 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 viene selezionata l'icona per la finestra di dialogo.

szHelpFile[128]

Tipo: TCHAR[128]

Questo membro viene ignorato.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	cpl.h

Vedi anche

CPLINFO