Retrieves the current configuration of a communications device.

BOOLEAN GetCommConfig(
  COMMHANDLE hCommDev,    // handle to communications service
  LPCOMMCONFIG lpCC,      // configuration information
  LPDWORD lpdwSize        // size of buffer
);

Parameters

hCommDev

[in] Handle to the open communications device.

lpCC

[out] Pointer to a buffer that receives a COMMCONFIG structure.

lpdwSize

[in/out] Pointer to a variable that specifies 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 Values

Non-zero

Success.

0 (zero)

Failure. To determine the status, call GetLastRtError.

Status

E_DISCONNECTED

COMM channel is closed

E_PARAM

Invalid parameter

Requirements

Requirements