Функция обратного вызова TUISPIDLLCALLBACK (tspi.h)

Статья
08/26/2023

Функция DllCallbackProc вызывается библиотекой DLL пользовательского интерфейса для отправки частного блока параметров поставщику службы. Каждый вызов обратного вызова приводит к вызову функции TSPI_providerGenericDialogData в поставщике услуг, связанном с указанным объектом. Содержимое блока параметров определяется поставщиком услуг и библиотекой DLL пользовательского интерфейса. Поставщик услуг может изменять содержимое блока параметров; при возврате этой функции TAPI копирует измененные данные обратно в исходный блок параметров DLL пользовательского интерфейса.

Тип TUISPIDLLCALLBACK определяет указатель на эту функцию обратного вызова. DllCallbackProc — это заполнитель для имени функции, определяемой приложением.

Синтаксис

TUISPIDLLCALLBACK Tuispidllcallback;

LONG Tuispidllcallback(
  DWORD_PTR dwObjectID,
  DWORD dwObjectType,
  LPVOID lpParams,
  DWORD dwSize
)
{...}

Параметры

dwObjectID

Идентификатор объекта типа, указанного dwObjectType.

dwObjectType

Одна из констант TUISPIDLL_OBJECT_, указывающая тип объекта, определяемого dwObjectID.

TUISPIDLL_OBJECT_LINEID

Параметр dwObjectID — это идентификатор устройства строки (dwDeviceID). Используется при вызове обратного вызова во время обработки TUISPI_lineConfigDialog или TUISPI_lineConfigDialogEdit.

TUISPIDLL_OBJECT_PHONEID

Параметр dwObjectID — это идентификатор устройства телефона (dwDeviceID). Используется при вызове обратного вызова во время обработки TUISPI_phoneConfigDialog.

TUISPIDLL_OBJECT_PROVIDERID

Параметр dwObjectID является постоянным идентификатором поставщика. Используется при вызове обратного вызова во время обработки TUISPI_providerConfig, TUISPI_providerInstall или TUISPI_providerRemove.

TUISPIDLL_OBJECT_DIALOGINSTANCE

Параметр dwObjectID — это HDRVDIALOGINSTANCE, возвращаемый поставщику услуг при отправке LINE_CREATEDIALOGINSTANCE сообщения. Используется при вызове обратного вызова во время обработки TUISPI_providerGenericDialog.

lpParams

Указатель на область памяти, используемую для хранения блока параметров.

dwSize

Размер блока параметров в байтах.

Примечание Если параметры размера в структуре неверны, существует вероятность того, что данные могут быть перезаписаны. Дополнительные сведения о настройке размеров структуры см. в разделе о выделении памяти .