2.2.40 _RPC_FAX_OUTBOUND_ROUTING_GROUPW

The _RPC_FAX_OUTBOUND_ROUTING_GROUPW data type is used as an array of structures passed as an output byte-array argument for FAX_EnumOutboundGroups (section 3.1.4.1.26). The group name contained by this structure describes one Routing Group (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 (16 bytes)

...

...

...

Variable_Data (variable)

...

Fixed_Portion (16 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

lpwstrGroupNameOffset

dwNumDevices

lpdwDevicesOffset

Status

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

lpwstrGroupNameOffset (4 bytes): Offset to the lpwstrGroupName field in the Variable_Data of the data type.

dwNumDevices (4 bytes): A DWORD value that holds the number of devices in the group. The value MUST be in the range between 0 and 1,000. The dwNumDevices parameter also indicates the length of the lpdwDevices array, which MUST NOT be larger than the actual number of devices.

lpdwDevicesOffset (4 bytes): Offset to the lpdwDevices field in the Variable_Data block of the structure.

Status (4 bytes): Current status of the group from the enumeration FAX_ENUM_GROUP_STATUS (section 2.2.59).

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

lpwstrGroupName (variable)

...

lpdwDevices (variable)

...

lpwstrGroupName (variable): A null-terminated character string containing the group name. The length of this string MUST be between 1 and 128 characters, excluding the length of the terminating null character. The group name is case-insensitive.

lpdwDevices (variable): A pointer to an array which contains dwNumDevices entries. Each DWORD value specifies one device identifier in the group. A device MUST appear only once in a group's device list. A single device can belong to one or more groups. Groups are not set to store invalid devices. The order of the devices in the array determines the order the devices are to be used to send faxes, when the group is selected.