Share via

Função SetDefaultCommConfigA (winbase.h)

  • Artigo

Define a configuração padrão de um dispositivo de comunicação.

Sintaxe

BOOL SetDefaultCommConfigA(
  [in] LPCSTR       lpszName,
  [in] LPCOMMCONFIG lpCC,
  [in] DWORD        dwSize
);

Parâmetros

[in] lpszName

O nome do dispositivo. Por exemplo, COM1 a COM9 são portas serial e LPT1 a LPT9 são portas paralelas.

[in] lpCC

Um ponteiro para uma estrutura COMMCONFIG .

[in] dwSize

O tamanho da estrutura apontada por lpCC, em bytes.

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

Observação

O cabeçalho winbase.h define SetDefaultCommConfig 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 (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

COMMCONFIG

Funções de comunicação

Recursos de comunicação

GetDefaultCommConfig