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_providerConfig、 TUISPI_providerInstall或 TUISPI_providerRemove期间调用回调时,使用此方法。
TUISPIDLL_OBJECT_DIALOGINSTANCE
dwObjectID 参数是 HDRVDIALOGINSTANCE,在发送LINE_CREATEDIALOGINSTANCE消息时返回给服务提供商。 在处理 TUISPI_providerGenericDialog期间调用回调时,使用此方法。
lpParams
指向用于保存参数块的内存区域的指针。
dwSize
参数块的大小(以字节为单位)。
返回值
如果成功,则返回零,或返回以下负错误值之一:
LINEERR_INVALPARAM、LINEERR_INVALPOINTER、LINEERR_NOMEM、LINEERR_OPERATIONFAILED。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tspi.h |