FaxServer.RegisterInboundRoutingExtension method

The RegisterInboundRoutingExtension method registers a fax inbound routing extension with the fax service. Registration takes place after the fax service restarts.

Syntax

FaxServer.RegisterInboundRoutingExtension( _
  ByVal bstrExtensionName As String, _
  ByVal bstrFriendlyName As String, _
  ByVal bstrImageName As String, _
  ByVal vMethods As Variant _
) As Long

Parameters

bstrExtensionName

Type: String

String that specifies the internal name of the fax routing extension DLL.

bstrFriendlyName

Type: String

String to associate with the fax routing extension DLL. This is the routing extension's user-friendly name, suitable for display.

bstrImageName

Type: String

String that specifies the full path and file name for the fax routing extension DLL. The path can include valid environment variables, for example, %SYSTEMDRIVE% and %SYSTEMROOT%.

vMethods

Type: Variant

VARIANT that specifies a safearray of Strings. The array must be unidimensional, it cannot be empty, and it must have a lower limit of zero. Each item (string) in the array must identify a routing method. The string must have the following format: Method name; Friendly name; Function Name; Method GUID

Remarks

Only an administrator can register a routing extension. Also, this method works only on the local fax server.

This property is not supported in Windows XP, and will return the error: FAX_E_NOT_SUPPORTED_ON_THIS_SKU.

To use this method, a user must have the farMANAGE_CONFIG access right.

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
FaxComex.h
DLL
Fxscomex.dll

See also

FaxServer

IFaxServer