Enabling and Disabling a Fax Routing Method

A fax routing method is an action that is performed each time a fax is received on a port. The fax service executes only the routing methods that have been enabled for the port when it routes an incoming fax transmission.

In the Win32 Environment

A fax client application can call the FaxEnableRoutingMethod function to enable a fax routing method for a particular fax device. It can also call the function to disable a routing method enabled by an earlier call to FaxEnableRoutingMethod or by the fax service administration application.

To query whether a fax routing method is currently enabled or disabled, an application can call the FaxEnumRoutingMethods function.

Note that an application must first call the FaxOpenPort function to obtain a fax port handle before calling the FaxEnableRoutingMethod or the FaxEnumRoutingMethods functions.

In the COM Implementation Environment

If you are writing a C/C++ application, you can call the IFaxRoutingMethod::put_Enable property method to enable or disable a fax routing method on a specific port. To enable a fax routing method, a fax client application must pass a value of TRUE to IFaxRoutingMethod::put_Enable. The IFaxRoutingMethod::get_Enable method retrieves the Enable property for a FaxRoutingMethod object. You must retrieve an IDispatch interface pointer for a FaxPort object before you can create a FaxRoutingMethod object. For information about the steps required to create a FaxRoutingMethod object, and for a list of properties and methods, see IFaxRoutingMethod.

If you are writing a Microsoft Visual Basic application, you can set the Enable property of the FaxRoutingMethod object to enable or disable a fax routing method on a specific port. If this property is equal to TRUE, the routing method is enabled for the port. You must create an instance of a FaxPort object before you can create a FaxRoutingMethod object. For more information about the steps required to create the object, and for a list of properties and methods of the object, see FaxRoutingMethod object (Visual Basic).