2.2.49 FAX_ROUTING_EXTENSION_INFO

The FAX_ROUTING_EXTENSION_INFO data type defines the format in which the routing extensions are enumerated and can be returned by a call to FAX_EnumRoutingExtensions (section 3.1.4.1.30). The call can return a pointer to an array of routing extensions, where each element of the array is of this type. The information contained in each FAX_ROUTING_EXTENSION_INFO structure describes one Fax Routing Extension (section 3.1.1).

This data structure is custom marshaled as follows and uses the custom-marshaling rules defined in section 2.2.1.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Fixed_Portion (44 bytes)

...

...

...

Variable_Data (variable)

...

Fixed_Portion (44 bytes):


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

dwSizeOfStruct

lpcwstrFriendlyNameOffset

lpcwstrImageNameOffset

lpcwstrExtensionNameOffset

Version (20 bytes)

...

...

...

Status

dwLastError

dwSizeOfStruct (4 bytes): A DWORD ([MS-DTYP] section 2.2.9) that holds the size, in bytes, of the size of the structure. MUST be set to 44 bytes.

lpcwstrFriendlyNameOffset (4 bytes): Offset to the lpcwstrFriendlyName field in the Variable_Data portion of the structure.

lpcwstrImageNameOffset (4 bytes): Offset to the lpcwstrImageName field in the Variable_Data portion of the structure.

lpcwstrExtensionNameOffset (4 bytes): Offset to the lpcwstrExtensionName field in the Variable_Data portion of the structure.

Version (20 bytes): A FAX_VERSION (section 2.2.22) structure that holds version information for the fax routing execution component.<11>

Status (4 bytes): A FAX_ENUM_PROVIDER_STATUS (section 2.2.57) enumeration which holds load status of the fax extension.

dwLastError (4 bytes): A DWORD value that holds the Win32 error code that was encountered while the extension was loaded and initialized.

Variable_Data (variable):


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

lpcwstrFriendlyName (variable)

...

lpcwstrImageName (variable)

...

lpcwstrExtensionName (variable)

...

lpcwstrFriendlyName (variable): A null-terminated string which holds the FSP user-friendly name, suitable for display.

lpcwstrImageName (variable): A null-terminated string which holds the full path and file name for the FSP binary.

lpcwstrExtensionName (variable): A null-terminated string which holds the name of the telephony service provider associated with the devices for the FSP.