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 tramite COM9 sono porte seriali e LPT1 a LPT9 sono porte parallele.

[in] hWnd

Handle nella finestra che possiede la finestra di dialogo. Questo parametro può essere qualsiasi handle di finestra valido oppure deve essere NULL se la finestra di dialogo non ha 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione CommConfigDialog richiede una libreria di collegamento dinamico (DLL) fornita dal fornitore dell'hardware di comunicazione.

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

COMMCONFIG

Funzioni di comunicazione

Risorse di comunicazione