Compartilhar via


Função GetCommProperties (winbase.h)

Recupera informações sobre as propriedades de comunicação de um dispositivo de comunicação especificado.

Sintaxe

BOOL GetCommProperties(
  [in]  HANDLE     hFile,
  [out] LPCOMMPROP lpCommProp
);

Parâmetros

[in] hFile

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

[out] lpCommProp

Um ponteiro para uma estrutura COMMPROP na qual as informações de propriedades de comunicação são retornadas. Essas informações podem ser usadas em chamadas subsequentes para a função SetCommState, SetCommTimeouts ou SetupComm para configurar o dispositivo de comunicações.

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 GetCommProperties retorna informações de um driver de dispositivo sobre as configurações compatíveis com o driver.

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 (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

COMMPROP

Funções de comunicação

Recursos de comunicação

CreateFile

Setcommstate

Setcommtimeouts

SetupComm