Platform SDK: Fax Services

IFaxPort::put_Receive

The IFaxPort::put_Receive method changes the Receive property for a FaxPort object. The Receive property is a Boolean value that indicates whether a specified fax port is enabled to receive faxes.

Before calling this method a fax client application can call the IFaxPort::get_CanModify method to ensure that the client has permission to modify configuration information for the specified fax port.

Visual Basic Reference

HRESULT put_Receive(
  BOOL newVal  // new receive enabled/disabled flag value
);

Parameters

newVal
[in] Specifies the new value to assign to the flag. To enable a fax port to receive faxes, a fax client application must pass a value of TRUE to the IFaxPort::put_Receive method.

Return Values

Returns an HRESULT value indicating success or failure. If the method succeeds, it returns S_OK. Otherwise, it returns a COM-defined error code.

You should not check directly for success or failure. Use the COM SUCCEEDED and FAILED macros instead.

Remarks

The IFaxPort::get_Receive method returns a value of TRUE if the fax port is enabled to receive faxes.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in faxcom.h.
  Import Library: Included as a resource in faxcom.dll.

See Also

Fax Service Client Application Programming Interface Overview, Fax Service Client API Interfaces, IFaxPort, IFaxPorts, IFaxPort::get_Receive, IFaxPort::CanModify