IFaxDevice::get_ReceiveMode method (faxcomex.h)

Article
07/27/2022

The ReceiveMode property is a value from the FAX_DEVICE_RECEIVE_MODE_ENUM enumeration that defines the way a device answers an incoming call. The value assigned to this property indicates whether the device does not answer the call, the device can answer the call manually, or the device answers the call automatically.

This property is read/write.

Syntax

HRESULT get_ReceiveMode(
  FAX_DEVICE_RECEIVE_MODE_ENUM *pReceiveMode
);

Parameters

pReceiveMode

Return value

None

Remarks

You can set only one device to receive faxes manually at any given time. If you set a device to answer manually and another device is already set to the manual mode, the device that had been previously set will automatically change to the no-answer mode. You should call the IFaxDevice::Refresh method on that device to see the change.

Some devices, such as virtual devices, do not support the manual-answer receive mode. For those devices, the ReceiveMode will fail if you set the receive mode to fdrmMANUAL_ANSWER. In C++, the method will return an ERROR_NOT_SUPPORTED error code in an HRESULT format.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	faxcomex.h
DLL	Fxscomex.dll