Struttura NEWCPLINFOA (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 tagNEWCPLINFOA {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHelpContext;
LONG_PTR lData;
HICON hIcon;
CHAR szName[32];
CHAR szInfo[64];
CHAR szHelpFile[128];
} NEWCPLINFOA, *LPNEWCPLINFOA;
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 |