Platform SDK: Fax Services

Querying Fax Port Data (COM Implementation)

The FaxPort object is available for a fax client application to query the permanent line identifier of a port and the port's current status. You can also retrieve the transmission priority assigned to the port, the number of rings an incoming fax call should wait before the port answers the call, and whether transmission and reception of faxes are currently enabled on the port.

After you create an instance of a FaxPort object, call the IFaxPort::GetStatus method (the Status method of the FaxPort object in Visual Basic) to create a FaxStatus object. Use the FaxStatus object to retrieve real-time status information about the parent FaxPort object.

You can call the IFaxPort::GetRoutingMethods method (the GetRoutingMethods method of the FaxPort object in Visual Basic) to create a FaxRoutingMethods object. You can then use this object to create an instance of a FaxRoutingMethod object. Use the FaxRoutingMethod object to retrieve fax routing configuration information for a fax port on a connected fax server. For more information, see Managing Fax Routing Data.

If you are writing a C/C++ application, after you create a FaxPort object for a specified fax port, you can call the IFaxPort interface methods to retrieve the properties of the port. For information about the steps required to create a FaxPort object, and for a list of properties and methods, see IFaxPort.

If you are writing a Visual Basic application, after you create a FaxPort object for a specified fax port, you can retrieve multiple properties of the object. See FaxPort object (Visual Basic) for more information about the steps required to create the object, and for a list of properties and methods of the object.