Поделиться через

Структуры TSPI

  • Статья

Структуры данных, которые использует TSPI, идентичны структурам, определенным в структурах TAPI, за исключением TUISPICREATEDIALOGINSTANCEPARAMS.

В случае большинства крупных структур данных ответственность за заполнение членов распределяется между поставщиком услуг и TAPI. Поставщик услуг должен сохранять значения, присутствующие в членах, принадлежащих TAPI. Описание элементов, которые должны быть заданы поставщиком услуг, а какие должны сохраняться, приведено в разделе Функции в функциях, ссылающихся на такую структуру данных.

Для каждой структуры в разделе справки перечислены следующие элементы:

  • Назначение структуры
  • Описание значений или полей
  • Описание расширяемости структуры
  • Необязательные комментарии об использовании структуры
  • Необязательные ссылки на другие функции, сообщения, константы или структуры.

Память для всех структур данных, представление которых публикуется и совместно используется как TAPI, так и поставщиком услуг, выделяется TAPI или приложением с помощью TAPI. TAPI передает указатель на функцию TSPI, которая возвращает сведения. TSPI заполняет структуру данных запрошенными сведениями. Если операция является асинхронной, сведения недоступны, пока асинхронный обратный вызов ответа не укажет на успешное выполнение.

Примечание

Некоторые структуры включают поля Размер и Смещение для определения расположения и длины строк в переменной части структуры. Если поставщику услуг предлагается добавить строку, но она недоступна, поставщик услуг должен указать это условие одним из следующих способов:

  • Задайте для полей Размер и Смещение значение 0.
  • Задайте для поля Смещение значение, отличное от нуля, а для параметра Размер задайте значение 0.
  • Задайте для поля Смещение ненулевое значение, для параметра Размер — значение 1, а для байта в поле Смещение — значение 0.