Функция GetDefaultCommConfig

Функция GetDefaultCommConfig извлекает заданную по умолчанию конфигурацию для указанного коммуникационного устройства.

Синтаксис

BOOL GetDefaultCommConfig(
  LPCTSTR lpszName,
  LPCOMMCONFIG lpCC,
  LPDWORD lpdwSize
);

Параметры

lpszName

[in] Указатель на символьную строку с нулем в конце, определяющую имя устройства.

lpCC

[out] Указатель на буфер, который получает структуру COMMCONFIG.

lpdwSize

[in, out] Указатель на переменную, определяющую размер буфера, на который указывает параметр lpCC, в байтах. После возвращения значения функцией, переменная содержит скопированное число байтов, если функция завершается успешно, или необходимое число байтов, если буфер был слишком маленький.

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

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

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

Замечания

Windows Me/98/95: GetDefaultCommConfigW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Смотри также

Обзор Коммуникационные ресурсы, Функции, используемые коммуникационными ресурсами, SetDefaultCommConfig, COMMCONFIG

Размещение и совместимость GetDefaultCommConfig
К	Windows XP	Да
л	Windows 2000 Professional	Да -
и	Windows NT Workstation	Да - версии 4.0
е	Windows Me	Да
н	Windows 98	Да
т	Windows 95	Да

С	Windows 2003 Server	Да
е	Windows 2000 Server	Да
р	Windows NT Server	Да версии 4.0
в
е
р
	Используемая библиотека	Kernel32.lib
	Заголовочный файл
	- объявлено в	Winbase.h
	- включено в	Windows.h
	Unicode	Реализуется как версии Unicode и ANSI. Обратите внимание!, что поддержка Windows Me/98/95 требует программы Microsoft Layer for Unicode.
	Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

В оглавление справки