Retrieves information about the communications properties for a specified communications device.

BOOLEAN GetCommProperties(
  COMMHANDLE hComm,           // handle to comm device
  LPCOMMPROP lpCommProp       // communications properties
);

Parameters

hComm

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

lpCommProp

[out] Pointer to a COMMPROP structure in which the communications properties information is returned. This information can be used in subsequent calls to SetCommState, SetCommTimeouts, or SetupComm to configure the communications device.

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

Remarks

This function returns information from a device driver about the configuration settings that are supported by the driver.

Requirements