Funzione CommConfigDialogA (winbase.h)
Visualizza una finestra di dialogo di configurazione fornita dal driver.
Sintassi
BOOL CommConfigDialogA(
[in] LPCSTR lpszName,
[in] HWND hWnd,
[in, out] LPCOMMCONFIG lpCC
);
Parametri
[in] lpszName
Nome del dispositivo per il quale deve essere visualizzata una finestra di dialogo. Ad esempio, COM1 a COM9 sono porte seriali e LPT1 a LPT9 sono porte parallele.
[in] hWnd
Handle per la finestra proprietaria della finestra di dialogo. Questo parametro può essere qualsiasi handle di finestra valido oppure deve essere NULL se la finestra di dialogo non deve avere alcun proprietario.
[in, out] lpCC
Puntatore a una struttura COMMCONFIG. Questa struttura contiene le impostazioni iniziali per la finestra di dialogo prima della chiamata e i valori modificati dopo la chiamata.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
La funzione CommConfigDialog
Nota
L'intestazione winbase.h definisce CommConfigDialog 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 |
| server minimo supportato | Windows Server 2003 |
| piattaforma di destinazione | Finestre |
| intestazione |
winbase.h (include Windows.h) |
| libreria |
Kernel32.lib |
| dll | Kernel32.dll |