Функция GetCommProperties (winbase.h)

Извлекает сведения о свойствах связи для указанного устройства связи.

Синтаксис

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

Параметры

[in] hFile

Дескриптор устройства связи. Функция CreateFile возвращает этот дескриптор.

[out] lpCommProp

Указатель на структуру COMMPROP , в которой возвращаются сведения о свойствах связи. Эти сведения можно использовать в последующих вызовах функции SetCommState, SetCommTimeouts или SetupComm для настройки устройства связи.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Функция GetCommProperties возвращает из драйвера устройства сведения о параметрах конфигурации, поддерживаемых драйвером.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

COMMPROP

Функции связи

Ресурсы связи

CreateFile

SetCommState

SetCommTimeouts

SetupComm