Compartilhar via


Função GetCommConfig (winbase.h)

Recupera a configuração atual de um dispositivo de comunicação.

Para recuperar as definições de configuração padrão do gerenciador de dispositivos, use a função GetDefaultCommConfig .

Sintaxe

BOOL GetCommConfig(
  [in]      HANDLE       hCommDev,
  [out]     LPCOMMCONFIG lpCC,
  [in, out] LPDWORD      lpdwSize
);

Parâmetros

[in] hCommDev

Um identificador para o dispositivo de comunicação aberta. A função CreateFile retorna esse identificador.

[out] lpCC

Um ponteiro para um buffer que recebe uma estrutura COMMCONFIG .

[in, out] lpdwSize

O tamanho, em bytes, do buffer apontado por lpCC. Quando a função retorna, a variável contém o número de bytes copiados se a função for bem-sucedida ou o número de bytes necessários se o buffer for muito pequeno.

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, use a função GetLastError .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
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

CreateFile

GetDefaultCommConfig

SetCommConfig