FaxRoutingMethod Object (Visual Basic)

The FaxRoutingMethod object permits a fax client Visual Basic application to access fax routing configuration information for a fax port on a connected fax server. Use this object to enable or disable a fax routing method on a specific fax port, and to retrieve and set the properties of FaxRoutingMethod objects. There is one FaxRoutingMethod object for each routing method associated with the port.

The FaxRoutingMethod object has the following properties:

• Properties to retrieve, enable, or disable a fax routing method for a specific FaxPort object. (Fax routing methods are defined by fax routing extension DLLs.)
• Properties to retrieve attributes of a FaxRoutingMethod object, such as the name of the DLL that exports the routing method. Attributes also include the GUID and function name that uniquely identify the routing method, and the routing method's user-friendly name.

A routing method is an action that is performed each time a fax is received on a port. If fax reception is not enabled on a port, the fax service disregards the routing methods associated with the port. When the service receives a fax, it executes only those routing methods that have been enabled for a device.

When to Implement

You should not implement this class. The Microsoft standard implementation provides complete functionality. You can use the Visual Basic Object Browser to view the FaxRoutingMethod object's type library information in Visual Basic syntax.

To create a FaxRoutingMethod object

1. Call the Visual Basic CreateObject function to create a FaxServer object.
2. Call the GetRoutingMethods method of the FaxServer object to create a FaxRoutingMethods object on the connected fax server.
3. Retrieve the Count property and then the Item property for the FaxRoutingMethods collection to create a FaxRoutingMethod object.

Following is a list of the Visual Basic properties of FaxRoutingMethod objects.

Dim lDeviceId As Long
lDeviceId = objFaxRoutingMethod.DeviceId

Dim strDeviceName As String
strDeviceName = objFaxRoutingMethod.DeviceName

' Retrieve
Dim lEnable As LONG
lEnable = objFaxRoutingMethod.Enable
' Assign
objFaxRoutingMethod.Enable = – 1

Dim strExtName As String
strExtName = objFaxRoutingMethod.ExtensionName

Dim strFrName As String
strFrName = objFaxRoutingMethod.FriendlyName

Dim strFuncName As String
strFuncName = objFaxRoutingMethod.FunctionName

Dim strGuid As String
strGuid = objFaxRoutingMethod.Guid

Dim strImageName As String
strImageName = objFaxRoutingMethod.ImageName

Dim strRData As String
strRData = objFaxRoutingMethod.RoutingData