PFAXROUTEENUMFILES 回调函数 (faxroute.h)

传真路由方法调用 FaxRouteEnumFiles 回调函数,以枚举与收到的传真文档关联的传真文件列表中的文件。

FaxRoutingMethod 如果调用 FaxRouteEnumFiles,则传递指向 FaxRouteEnumFile 回调函数的指针。

语法

PFAXROUTEENUMFILES Pfaxrouteenumfiles;

BOOL Pfaxrouteenumfiles(
  [in]      DWORD JobId,
  [in]      GUID *Guid,
  [in]      PFAXROUTEENUMFILE FileEnumerator,
  [in, out] PVOID Context
)
{...}

参数

[in] JobId

类型:DWORD

指定一个唯一的数字,用于标识接收传真文档的传真作业。

[in] Guid

类型:GUID*

指向包含传真路由方法 GUID 的以 null 结尾的 Unicode 字符串的指针。

[in] FileEnumerator

类型:PFAXROUTEENUMFILE

指向传真路由扩展插件定义的 FaxRouteEnumFile 回调函数的指针。 FaxRouteEnumFile 接收与收到的传真文档关联的传真文件列表中的文件名。

[in, out] Context

类型:PVOID

指向 FaxRouteEnumFiles 传递给 FaxRouteEnumFile 函数的扩展定义值的指针。 传真路由方法可以定义此值。

返回值

类型:BOOL

如果函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 若要获取扩展的错误信息,传真服务 GetLastError调用。

言论

当传真服务调用 FaxRouteInitialize 函数时,传真服务会传递指向 FaxRouteEnumFiles 回调函数的指针。 服务在 FAX_ROUTE_CALLBACKROUTINES 结构中传递指针。

PFAXROUTEENUMFILES 数据类型定义指向 FaxRouteEnumFiles 函数的指针。

传真路由扩展 DLL 必须提供由 FileEnumerator 参数指定的 FaxRouteEnumFile 函数。 传真服务调用 FaxRouteEnumFile 来枚举传真文件列表中的传真路由方法的文件。 传真服务针对传真文件列表中的每个文件调用 FaxRouteEnumFile 一次。

有关详细信息,请参阅 传真文件列表

要求

要求 价值
最低支持的客户端 Windows 2000 Professional、Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 faxroute.h

另请参阅

FAX_ROUTE_CALLBACKROUTINES

传真路由扩展应用程序编程接口概述

传真路由扩展函数

FaxRouteEnumFile

FaxRouteInitialize