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 serial 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 de COMMCONFIG . Essa estrutura contém as configurações iniciais da caixa de diálogo antes da chamada e valores alterados após a chamada.

Valor de retorno

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

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

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows XP
servidor com suporte mínimo Windows Server 2003
da Plataforma de Destino Windows
cabeçalho winbase.h (inclua Windows.h)
biblioteca Kernel32.lib
de DLL Kernel32.dll

Consulte também

COMMCONFIG

Funções de comunicação

recursos de comunicação