(faxdev.h) FAX_SEND 结构

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

另请参阅

FAX_DEV_STATUS

传真服务提供商结构

FaxDevSend

LINE_CALLSTATE

使用传真服务提供商 API