| Platform SDK: Fax Services |
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.
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.
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 the IFaxRoutingMethod::put_Enable method. 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 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. See FaxRoutingMethod object (Visual Basic) for more information about the steps required to create the object, and for a list of properties and methods of the object.