FaxServer.GetPorts method

The GetPorts method creates and initializes a FaxPorts object for a specified FaxServer object. The FaxPorts object allows enumeration of fax port configuration information for the connected fax server.

Syntax

FaxServer.GetPorts( _
  ByRef retVal As Variant _
) As Long

Parameters

retVal [out]

Type: Variant*

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

Remarks

The GetPorts method retrieves an IDispatch interface pointer to a FaxPorts object. A fax client application can also access the IFaxPorts interface directly by calling the IUnknown::QueryInterface method to retrieve an interface pointer.

A fax client application should not call the CoCreateInstance function to retrieve an IFaxPorts interface pointer because it will not be instantiated correctly.

Requirements

Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Faxcom.h
DLL
Faxcom.dll

See also

FaxServer

Fax Service Client API for Windows 2000

Fax Service Client API Interfaces

FaxServer

IFaxPorts

IFaxPort

IUnknown::QueryInterface