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 中,应用程序可以访问函数 lineConfigDialog 和 phoneConfigDialog,这些函数允许在安装后配置特定线路或电话的参数。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tspi.h |