Compartilhar via


Função SetDefaultCommConfigA (winbase.h)

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 de COMMCONFIG .

[in] dwSize

O tamanho da estrutura apontada por lpCC, em bytes.

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

Nota

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 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

GetDefaultCommConfig