Retrieves the current control settings for a specified communications device.

BOOLEAN GetCommState(
  COMMHANDLE hComm,  // handle to communications device
  LPDCB lpDCB        // device-control block
);

Parameters

hComm

[in] Handle to the communications device. OpenComm returns this handle.

lpDCB

[out] Pointer to a DCB structure that receives the control settings information.

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