Compartilhar via


Função CommConfigDialogA (winbase.h)

Exibe uma caixa de diálogo de configuração fornecida pelo driver.

Sintaxe

BOOL CommConfigDialogA(
  [in]      LPCSTR       lpszName,
  [in]      HWND         hWnd,
  [in, out] LPCOMMCONFIG lpCC
);

Parâmetros

[in] lpszName

O nome do dispositivo para o qual uma caixa de diálogo deve ser exibida. Por exemplo, COM1 a COM9 são portas seriais e LPT1 a LPT9 são portas paralelas.

[in] hWnd

Um identificador para a janela que possui a caixa de diálogo. Esse parâmetro pode ser qualquer identificador de janela válido ou deve ser NULL se a caixa de diálogo não tiver proprietário.

[in, out] lpCC

Um ponteiro para uma estrutura COMMCONFIG . Essa estrutura contém configurações iniciais para a caixa de diálogo antes da chamada e valores alterados após a chamada.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função CommConfigDialog requer uma DLL (biblioteca de vínculo dinâmico) fornecida pelo fornecedor de hardware de comunicações.

Observação

O cabeçalho winbase.h define CommConfigDialog como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

COMMCONFIG

Funções de comunicação

Recursos de comunicação