IFaxRoutingMethods::get_Item

The IFaxRoutingMethods::get_Item method creates a FaxRoutingMethod object for a specified fax routing method. The object allows enumeration of fax routing information for a specified FaxPort object.

Visual Basic Reference

HRESULT get_Item(
  LONG Index,    // index of the fax routing method
  VARIANT *pVal  // receives IDispatch pointer to a 
                 // FaxRoutingMethod object
);

Parameters

Index

[in] Specifies a LONG variable that indicates the fax routing method to retrieve. Valid values for this parameter are in the range from 1 to n, where n is the number of fax routing methods returned by a call to the IFaxRoutingMethods::get_Count method.

pVal

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

Return Values

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.

Remarks

A fax client application can also access the IFaxRoutingMethod interface directly by calling the IUnknown::QueryInterface method to retrieve an IFaxRoutingMethod interface pointer.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in faxcom.h.
  Import Library: Included as a resource in faxcom.dll.

See Also

Fax Service Client Application Programming Interface Overview, Fax Service Client API Interfaces, IFaxRoutingMethods, IFaxRoutingMethods::get_Count, IFaxRoutingMethod, IFaxPort::GetRoutingMethods, IUnknown::QueryInterface