IFaxPort::GetRoutingMethods method (faxcom.h)

Article
10/13/2021

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.

Syntax

HRESULT GetRoutingMethods(
  [out] VARIANT *retval
);

Parameters

[out] retval

Type: IDispatch*

Pointer to a VARIANT structure that receives an IDispatch interface pointer to a FaxRoutingMethods object. The method returns a ppdispVal member with a VT_DISPATCH data type.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

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.

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