TUISPIDLLCALLBACK 回调函数 (tspi.h)

DLL 调用 DllCallbackProc 函数,以向服务提供程序发送私有参数块。 每次调用回调都会在与指定对象关联的服务提供程序中调用 TSPI_providerGenericDialogData 函数。 参数块的内容由服务提供程序和 UI DLL 定义。 服务提供商可以修改参数块的内容;当此函数返回时,TAPI 会将修改的数据复制回原始 UI 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_providerConfigTUISPI_providerInstallTUISPI_providerRemove期间调用回调时,使用此方法。

TUISPIDLL_OBJECT_DIALOGINSTANCE

dwObjectID 参数是 HDRVDIALOGINSTANCE,在发送LINE_CREATEDIALOGINSTANCE消息时返回给服务提供商。 在处理 TUISPI_providerGenericDialog期间调用回调时,使用此方法。

lpParams

指向用于保存参数块的内存区域的指针。

dwSize

参数块的大小(以字节为单位)。

注意 如果结构中的 size 参数不正确,则有可能覆盖数据。 有关设置结构大小的详细信息,请参阅 内存分配 主题。
 

返回值

如果成功,则返回零,或返回以下负错误值之一:

LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED。

要求

要求
目标平台 Windows
标头 tspi.h

另请参阅

LINE_CREATEDIALOGINSTANCE

TSPI_providerGenericDialogData

TUISPIDLL_OBJECT_

TUISPI_lineConfigDialog

TUISPI_lineConfigDialogEdit

TUISPI_phoneConfigDialog

TUISPI_providerConfig

TUISPI_providerGenericDialog

TUISPI_providerInstall

TUISPI_providerRemove