FAX_SEND结构包含有关出站传真文档的信息。 结构包含保存传真数据流的文件的名称、呼叫设备的名称和电话号码,以及接收设备的名称和电话号码。
语法
typedef struct _FAX_SEND {
DWORD SizeOfStruct;
LPWSTR FileName;
LPWSTR CallerName;
LPWSTR CallerNumber;
LPWSTR ReceiverName;
LPWSTR ReceiverNumber;
BOOL Branding;
HCALL CallHandle;
DWORD Reserved[3];
} FAX_SEND, *PFAX_SEND;
成员
SizeOfStruct
类型:DWORD
指定 FAX_SEND 结构的大小(以字节为单位)。 在调用 FaxDevSend 函数之前,传真服务将此成员设置为 sizeof (FAX_SEND) 。
FileName
类型: LPWSTR
指向以 null 结尾的 Unicode 字符串的指针,该字符串指定包含出站传真文档数据流的文件的完整路径。 数据流是 TIFF 类 F 文件。 有关详细信息,请参阅 传真图像格式。
CallerName
类型: LPWSTR
指向以 null 结尾的 Unicode 字符串的指针,该字符串指定调用设备的名称。 FSP 发送传真时,FSP 会将此名称发送到远程接收设备。 有关更多信息,请参见下面的“备注”部分。
CallerNumber
类型: LPWSTR
指向以 null 结尾的 Unicode 字符串的指针,该字符串指定呼叫设备的电话号码。 (此号码也是 TSID.) FSP 将在 FSP 发送传真时将此号码发送到远程接收设备。 有关更多信息,请参见下面的“备注”部分。
ReceiverName
类型: LPWSTR
指向以 null 结尾的 Unicode 字符串的指针,该字符串指定将接收出站传真文档的设备的名称。
ReceiverNumber
类型: LPWSTR
指向以 null 结尾的 Unicode 字符串的指针,该字符串指定将接收出站传真文档的设备电话号码。 这是 FSP 将拨打的电话号码。
如果指定 CallHandle 成员, ReceiverNumber 成员必须为 NULL。
Branding
类型: BOOL
保留。
CallHandle
类型: HCALL
保留;必须设置为 NULL。
Reserved[3]
类型:DWORD
此成员由 Microsoft 保留。 它必须设置为零。
备注
FSP 可以重新设置 CallerName 和 CallerNumber 成员的格式。 然后,FSP 可以将重新格式化的数据作为所谓的用户标识符 (CSI) 传输到远程发送设备,以遵守国际电信联盟 (ITU) (研究组) 的建议。 有关详细信息,请参阅 FAX_DEV_STATUS 结构的 RoutingInfo 和 CSI 成员。
FSP 还可以使用重新格式化的数据向传真传输添加品牌。
要求
| 最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 标头 | faxdev.h |