Platform SDK: Fax Services |
The IFaxPort::GetRoutingMethods interface method creates a FaxRoutingMethods object for the parent FaxPort object. The FaxRoutingMethods object allows enumeration of the fax routing methods associated with a fax port. Fax routing methods are defined by a fax routing extension DLL.
HRESULT GetRoutingMethods( VARIANT *retVal // receives IDispatch pointer to // FaxRoutingMethods object );
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.
The IFaxPort::GetRoutingMethods interface method retrieves an IDispatch interface pointer to a FaxRoutingMethods object. This object is derived from the FaxPort object specified by the IFaxPorts interface.
A fax client application can access the IFaxRoutingMethods interface directly by calling the IUnknown::QueryInterface method to retrieve an interface pointer.
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, IFaxPort, IFaxPorts, IFaxRoutingMethods, IUnknown::QueryInterface