PFAXROUTEENUMFILES 回调函数 (faxroute.h)

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

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

语法

PFAXROUTEENUMFILES Pfaxrouteenumfiles;

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

参数

[in] JobId

类型:DWORD

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

[in] Guid

类型: GUID*

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

[in] FileEnumerator

类型: PFAXROUTEENUMFILE

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

[in, out] Context

类型: PVOID

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

返回值

类型: BOOL

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

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

备注

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

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

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

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

要求

   
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 faxroute.h

请参阅

FAX_ROUTE_CALLBACKROUTINES

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

传真路由扩展函数

FaxRouteEnumFile

FaxRouteInitialize