Platform SDK: Fax Services |
The IFaxRoutingMethod::get_DeviceId method retrieves the DeviceId property for a FaxPort object. The DeviceId property is a number representing the line identifier for the fax port.
HRESULT get_DeviceId( LONG *pVal // receives numeric line identifier );
Returns an HRESULT value indicating success or failure. If the method succeeds, it returns S_OK. Otherwise, it returns a COM-defined error code.
You should not check directly for success or failure. Use the COM SUCCEEDED and FAILED macros instead.
A fax client application can use the DeviceId property to uniquely identify a fax port. You can call the IFaxRoutingMethod::get_DeviceName method to retrieve the user-friendly name for a port. Note, however, that it is possible for multiple fax ports to have the same user-friendly name.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Unsupported.
Header: Declared in faxcom.h.
Import Library: Included as a resource in faxcom.dll.
Fax Service Client Application Programming Interface Overview, Fax Service Client API Interfaces, IFaxRoutingMethods, IFaxRoutingMethod, IFaxPort, IFaxPorts, IFaxRoutingMethod::get_DeviceName