GetCommConfig function (winbase.h)

Retrieves the current configuration of a communications device.

To retrieve the default configuration settings from the device manager, use the GetDefaultCommConfig function.


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


[in] hCommDev

A handle to the open communications device. The CreateFile function returns this handle.

[out] lpCC

A pointer to a buffer that receives a COMMCONFIG structure.

[in, out] lpdwSize

The size, in bytes, of the buffer pointed to by lpCC. When the function returns, the variable contains the number of bytes copied if the function succeeds, or the number of bytes required if the buffer was too small.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, use the GetLastError function.


Requirement Value
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header winbase.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also


Communications Functions

Communications Resources