IFaxPorts 接口 (faxcom.h)

传真客户端应用程序使用 IFaxPorts 双接口来访问派生自 FaxServer 对象的 FaxPort 对象。 接口枚举与活动传真服务器的连接的端口配置信息。 FaxPorts 对象是 FaxPort 对象的集合。

IFaxPorts 接口包括允许传真客户端应用程序执行以下任务的方法。

  • 检索与传真服务器关联的传真端口数。
  • 创建和检索 FaxPort 对象的 IFaxPort 接口指针。

继承

IFaxPorts 接口继承自 IDispatch 接口。 IFaxPorts 还具有以下类型的成员:

方法

IFaxPorts 接口具有这些方法。

 
IFaxPorts::get_Count

IFaxPorts::get_Count 方法检索连接到连接的传真服务器的传真端口数。
IFaxPorts::get_Item

IFaxPorts::get_Item 方法为指定的传真端口创建 FaxPort 对象。 对象允许枚举与传真服务器的特定连接的端口配置信息。

注解

何时实现

不应实现此接口。 Microsoft 标准实现提供了完整的功能。

何时使用

使用 IFaxPorts 接口创建和检索指向 FaxPort 对象的 IFaxPort 接口指针。 与连接的传真服务器关联的每个端口都有一个 FaxPort 对象。

若要创建 FaxPort 对象的实例,请执行以下步骤。 请注意,传真客户端应用程序不应调用 CoCreateInstance 函数来检索 IFaxPort 接口指针。

  1. 调用 CoCreateInstance 函数以检索指向 IFaxServer 接口的 指针。
  2. 调用 IFaxServer::Connect 方法连接到活动传真服务器。
  3. 调用 IFaxServer::GetPorts 方法,为连接的传真服务器创建和初始化 FaxPorts 对象。
  4. 调用 IFaxPorts::get_Count 方法,然后调用 IFaxPorts::get_Item 方法来检索每个子 FaxPort 对象的 IDispatch 接口指针。 (还可以调用 IUnknown::QueryInterface 方法来检索 IFaxPort 接口 pointer.)
  5. 使用 IDispatch 接口指针调用 IFaxPort 接口方法。
  6. 调用 IFaxServer::D isconnect 方法以断开与传真服务器的连接。
  7. 为每个 FaxPort 对象调用 IUnknown::Release 方法以允许对象解除分配自身,并再次销毁 IFaxPorts 接口指针。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 faxcom.h

另请参阅

传真服务客户端 API 接口

适用于 Windows 2000 的传真服务客户端 API

IDispatch