IFaxPort::put_Priority method (faxcom.h)

The IFaxPort::get_Priority property is a number representing the transmission priority designated for a specified fax port. Priority determines the relative order in which available fax devices send outgoing transmissions.

This property is read/write.

Syntax

HRESULT put_Priority(
  long newVal
);

Parameters

newVal

Return value

None

Remarks

Note  Before setting a value for this property, a fax client application can call the IFaxPort::get_CanModify property to ensure that the client has permission to modify configuration information for the specified fax port.
 
When the fax server initiates an outgoing fax transmission, it chooses the fax port with the highest priority and send capability. If that port is not available, the server selects the next available port that follows in rank order, and so on. When a client application changes the priority for a fax port, the fax service adjusts the priority for the other fax ports attached to the server. The IFaxPort::get_Priority property has no effect on incoming transmissions.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header faxcom.h
DLL Faxcom.dll

See also

Fax Service Client API Interfaces

Fax Service Client API for Windows 2000

IFaxPort

IFaxPorts