传真客户端应用程序使用 IFaxPorts 双接口来访问派生自 FaxServer 对象的 FaxPort 对象。 接口枚举与活动传真服务器的连接的端口配置信息。 FaxPorts 对象是 FaxPort 对象的集合。
IFaxPorts 接口包括允许传真客户端应用程序执行以下任务的方法。
继承
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 接口指针。
- 调用 CoCreateInstance 函数以检索指向 IFaxServer 接口的 指针。
- 调用 IFaxServer::Connect 方法连接到活动传真服务器。
- 调用 IFaxServer::GetPorts 方法,为连接的传真服务器创建和初始化 FaxPorts 对象。
- 调用 IFaxPorts::get_Count 方法,然后调用 IFaxPorts::get_Item 方法来检索每个子 FaxPort 对象的 IDispatch 接口指针。 (还可以调用 IUnknown::QueryInterface 方法来检索 IFaxPort 接口 pointer.)
- 使用 IDispatch 接口指针调用 IFaxPort 接口方法。
- 调用 IFaxServer::D isconnect 方法以断开与传真服务器的连接。
- 为每个 FaxPort 对象调用 IUnknown::Release 方法以允许对象解除分配自身,并再次销毁 IFaxPorts 接口指针。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | faxcom.h |