TUISPI_providerGenericDialogData函数 (tspi.h)

当服务提供程序发送 LINE_SENDDIALOGINSTANCEDATA 消息时,将调用 UI DLL 中的 TUISPI_providerGenericDialogData 函数。 服务提供程序使用此函数自发更新在应用程序上下文中创建的对话框中的信息,同时处理特定的异步 TSPI 函数。 此函数是从执行 TUISPI_providerGenericDialogData 的单独线程调用的。 UI DLL 不应阻止在其中调用此函数的线程,但应处理数据并立即返回, (在必要时将消息发布到对话框) 。

如果导出 TUISPI_providerGenericDialog ,则实现是必需的。

语法

LONG TSPIAPI TUISPI_providerGenericDialogData(
  HTAPIDIALOGINSTANCE htDlgInst,
  LPVOID              lpParams,
  DWORD               dwSize
);

参数

htDlgInst

不透明标识符将函数的此实例与来自服务提供程序的特定请求的关联绑定。

lpParams

指向用于保存参数块的内存区域的指针。 此参数块的内容特定于服务提供程序及其关联的 UI DLL。 通过此参数块传送数据是单向到 UI DLL 的;对参数块所做的更改不会反映在服务提供程序中。 如果此参数设置为 NULL,则这是立即关闭对话框并清理 ( 在此清理) 期间不应调用 TUISPIDLLCALLBACK 的请求。 TAPI 在 将 lpParams 设置为 NULL 的情况下调用此函数,以在某些情况下强制清除对话框,例如调用 lineShutdown 且对话框仍然处于活动状态的应用程序。

dwSize

参数块的大小(以字节为单位)。 如果 lpParams 参数是指向字符串的指针,则大小必须包含 null 终止符。

返回值

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

LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED。

要求

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

另请参阅

LINE_SENDDIALOGINSTANCEDATA

TUISPIDLLCALLBACK

lineShutdown