IFaxPort::p ut_Tsid 方法 (faxcom.h)

IFaxPort::get_Tsid 属性是一个以 null 结尾的字符串,其中包含与传真端口关联的传输站标识符 (TSID) 。

此属性是可读写的。

语法

HRESULT put_Tsid(
  BSTR newVal
);

参数

newVal

返回值

备注

注意 在为此属性设置值之前,传真客户端应用程序可以调用 IFaxPort::get_CanModify 属性,以确保客户端有权修改指定传真端口的配置信息。
 
只有可打印的字符(如英文字母、数字符号和标点符号) (ASCII 范围0x20 0x7F) ,才能在调用的工作站标识符 (CSID) 中使用。

当传真服务在端口上接收传真时,该服务会将 TSID 传输到接收设备。

国际电信联盟 (ITU) 的 T.30 规范将 TSID 的值限制为 20 个 ASCII 字符。 如果传真客户端应用程序指定包含非 ASCII 字符的 TSID,则传真服务会删除这些字符。 如果 TSID 超过 20 个字符,服务将截断额外的字符。

IFaxPort::get_Tsid 分配 pVal 参数指向的缓冲区所需的内存。 客户端应用程序必须调用 SysFreeString 函数才能解除分配与此参数关联的资源。 有关详细信息,请参阅 释放传真资源

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 faxcom.h
DLL Faxcom.dll

另请参阅

传真服务客户端 API 接口

适用于 Windows 2000 的传真服务客户端 API

IFaxPort

IFaxPorts