Share via


FaxDeviceIds.SetOrder method

The SetOrder method changes the order of a device in the ordered FaxDeviceIds collection.

Syntax

FaxDeviceIds.SetOrder( _
  ByVal lDeviceId As Long, _
  ByVal lNewOrder As Long _
) As Long

Parameters

lDeviceId [in]

Type: Long

Specifies the device ID of the device whose order you want to change.

lNewOrder [in]

Type: Long

Specifies the new position of the device in the order.

Remarks

You identify the device with its device ID, and then choose a new place for it in the order. If you move the device closer to the top of the order, the devices below that position in the order will drop down to accommodate the change. If you move the device closer to the bottom of the order, the devices above that position in the order will move up to fill the gap caused by the change.

In a fax device group, the relative order of the devices within the group is significant. When the fax service initiates an outgoing job, it attempts to select the first fax device in the device group. If that device is not available, the service selects the next available device that follows in rank order, and so on. For more information, see Fax Device Groups.

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

Visual Basic Example

FaxDeviceIds

IFaxDeviceIds