TSPI_providerFreeDialogInstance 函数 (tspi.h)

TSPI_providerFreeDialogInstance 函数通知服务提供商与 hdDlgInst 关联的对话框已退出。 调用此函数后,服务提供商不应再使用 LINE_SENDDIALOGINSTANCEDATA 消息将数据发送到对话框。

此函数的实现是可选的;仅当服务提供程序使用 LINE_CREATEDIALOGINSTANCE 在应用程序上下文中生成自发对话框时,才需要

语法

LONG TSPIAPI TSPI_providerFreeDialogInstance(
  HDRVDIALOGINSTANCE hdDlgInst
);

参数

hdDlgInst

服务提供程序与应用程序上下文中对话框之间的关联的不透明标识符,该标识符作为 HDDlgInstance 成员在 TUISPICREATEDIALOGINSTANCEPARAMS 结构中使用创建对话框的LINE_CREATEDIALOGINSTANCE消息传递。

返回值

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

LINEERR_INVALPARAM、LINEERR_NOMEM、LINEERR_OPERATIONFAILED。

要求

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

另请参阅

LINE_CREATEDIALOGINSTANCE

LINE_SENDDIALOGINSTANCEDATA

TUISPICREATEDIALOGINSTANCEPARAMS