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.

Syntax

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

Parameters

[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.

Requirements

See also

COMMCONFIG

Communications Functions

Communications Resources

CreateFile

GetDefaultCommConfig

SetCommConfig