TUISPICREATEDIALOGINSTANCEPARAMS 结构 (tspi.h)

定义 TAPI 对话操作的参数。

语法

typedef struct tuispicreatedialoginstanceparams_tag {
  DRV_REQUESTID       dwRequestID;
  HDRVDIALOGINSTANCE  hdDlgInst;
  HTAPIDIALOGINSTANCE htDlgInst;
  LPCWSTR             lpszUIDLLName;
  LPVOID              lpParams;
  DWORD               dwSize;
} TUISPICREATEDIALOGINSTANCEPARAMS, *LPTUISPICREATEDIALOGINSTANCEPARAMS;

成员

dwRequestID

作为与自发 UI 关联的异步 TSPI 函数中的参数传递给服务提供程序的 dwRequestID 。 TAPI 使用此来标识要加载 UI DLL 的上下文并调用 TUISPI_providerGenericDialog 函数的应用程序。

hdDlgInst

与泛型对话框实例关联的服务提供商标识符。 由于可以在相同或多个应用程序中打开泛型对话框的多个实例，因此服务提供商必须确保其句柄在提供程序上下文中现有实例的范围内是唯一的。

htDlgInst

TAPI 会将创建的关联的标识符写入此成员。 如果创建关联失败，则此成员设置为 NULL ，在这种情况下，服务提供商无法在目标应用程序的上下文中自发地创建对话框。 服务提供商必须在消息中使用此标识符，才能将数据发送到 UI DLL (LINE_SENDDIALOGINSTANCEDATA) 。

lpszUIDLLName

指向 以 NULL 结尾的字符串的指针，该字符串指定要在应用程序上下文中加载的 UI DLL 的完全限定名称。

lpParams

指向要传达给 UI DLL 的 TUISPI_providerGenericDialog 函数的私有参数块的指针。 服务提供程序和 UI DLL 确定参数块的内容。 传输是单向的;UI DLL 无法修改参数块并将其返回到服务提供程序。 通常，此块会指示 UI DLL 显示哪个对话框，并包含要显示 (（如有必要）) 的信息。

dwSize

参数块的大小（以字节为单位）。

要求

另请参阅

LINE_SENDDIALOGINSTANCEDATA

TUISPI_providerGenericDialog