TSPI 结构

TSPI 使用的数据结构与 TAPI 结构中定义的数据结构相同, 但 TUISPICREATEDIALOGINSTANCEPARAMS 除外。

对于大多数较大的数据结构,填写成员的责任由服务提供商和 TAPI 负责。 服务提供商必须保留 TAPI 拥有的成员中存在的值。 引用该数据结构的函数的 Functions 节中提供了有关哪些成员必须由服务提供商设置和必须保留的成员的说明。

对于每个结构,参考部分列出了以下项:

  • 结构的用途
  • 值或字段的说明
  • 结构扩展性的说明
  • 有关使用 结构的可选注释
  • 对其他函数、消息、常量或结构的可选引用。

所有表示形式由 TAPI 发布和共享的数据结构的内存,服务提供程序由 TAPI 或使用 TAPI 的应用程序分配。 TAPI 传递指向返回信息的 TSPI 函数的指针。 TSPI 使用请求的信息填充数据结构。 如果操作是异步的,则在异步回复回调指示成功之前,信息不可用。

注意

某些结构包括 Size 和 Offset 字段,用于定义结构变量部分中字符串的位置和长度。 如果请求服务提供商添加字符串,但没有可用的字符串,则服务提供商必须通过以下方式之一指示此条件:

  • 将“大小”和“偏移量”字段都设置为 0。
  • 将 Offset 字段设置为非零,但“大小”设置为 0。
  • 将 Offset 字段设置为非零,将 Size 设置为 1,将 Offset 处的字节设置为 0。