TSPI_providerGenericDialogData 函数 (tspi.h)

TSPI_providerGenericDialogData函数通过 TUISPIDLLCALLBACK 函数从应用程序上下文中运行的 UI DLL 发送的服务提供程序数据。 lpParams 指向的内存块的内容由服务提供程序和 UI DLL 定义。 服务提供商可以修改参数块的内容;当此函数返回时,TAPI 会将修改的数据复制回原始 UI DLL 参数块。

如果与服务提供程序关联的 UI DLL 调用 TUISPIDLLCALLBACK,则实现是必需的。

语法

LONG TSPIAPI TSPI_providerGenericDialogData(
  DWORD_PTR dwObjectID,
  DWORD     dwObjectType,
  LPVOID    lpParams,
  DWORD     dwSize
);

参数

dwObjectID

dwObjectType 指定的类型的对象标识符。

dwObjectType

TUISPIDLL_OBJECT_常量之一,指定由 dwObjectID 标识的对象类型:

TUISPIDLL_OBJECT_LINEID

dwObjectID 是 dwDeviceID) (行设备标识符。

TUISPIDLL_OBJECT_PHONEID

dwObjectID 是电话设备标识符 (dwDeviceID)

TUISPIDLL_OBJECT_PROVIDERID

dwObjectID 是永久提供程序标识符。

TUISPIDLL_OBJECT_DIALOGINSTANCE

dwObjectID 是 HDRVDIALOGINSTANCE,在发送 LINE_CREATEDIALOGINSTANCE 消息时返回给服务提供商。

lpParams

指向用于保存参数块的内存区域的指针。 此参数块的内容特定于服务提供程序及其关联的 UI DLL。

dwSize

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

返回值

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

LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED。

要求

   
目标平台 Windows
标头 tspi.h

另请参阅

LINE_CREATEDIALOGINSTANCE

TUISPIDLLCALLBACK