TUISPI_providerConfig 函数 (tspi.h)

TUISPI_providerConfig 函数实现必须在调用应用程序的上下文中执行的 UI 元素。 此函数使 TSPI_providerConfig 函数在版本 2.0 及更高版本中已过时, (版本 1.4 及更早版本中受) 支持。

TUISPI_providerConfig 函数从用户收集配置信息。 它可以使用对话框,并且此对话框可以包含与其他 API 关联的子对话框 (,例如用于设置特定设备的 Comm/datamodem) 。

实现是可选的。

语法

LONG TSPIAPI TUISPI_providerConfig(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

参数

lpfnUIDLLCallback

指向 UI DLL 可以调用的函数的指针,以便与服务提供商 DLL 通信,以获取显示对话框和将更新的配置发送到服务提供商所需的信息。

hwndOwner

父窗口的句柄,函数可在其中创建配置期间所需的任何对话框窗口。

dwPermanentProviderID

服务提供商的永久提供程序标识符。

返回值

如果函数成功,则返回零;如果发生错误,则返回错误号。 可能的返回值如下所示:

LINEERR_OPERATIONFAILED,LINEERR_NOMEM。

注解

当服务提供程序正在使用 ((即调用 TSPI_providerInit TSPI_providerShutdown) 之间)时,可以调用此函数。

影响通过 TSPI 可见的行为的任何更改应仅在下一 TSPI_providerInit重新启动服务提供商时生效。

TAPI 级别没有直接对应的函数。 在 TAPI 中,应用程序可以访问函数 lineConfigDialogphoneConfigDialog,这些函数允许在安装后配置特定线路或电话的参数。

要求

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

另请参阅

TUISPI_lineConfigDialog

TUISPI_phoneConfigDialog

TUISPI_providerInstall

TUISPI_providerRemove