PFAXROUTEENUMFILES 回调函数（faxroute.h）

项目
07/16/2024

传真路由方法调用 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