ITLegacyAddressMediaControl2::ConfigDialogEdit 方法 (tapi3if.h)

ConfigDialogEdit 方法会导致指定线路设备的提供程序显示一个对话框,以允许用户配置与线路设备相关的参数。 配置数据由应用程序传入和传出此方法。 (数据与 ITLegacyAddressMediaControl::GetDevConfig 方法检索的数据相同,由 ITLegacyAddressMediaControl::SetDevConfig 方法设置的数据相同 )

语法

HRESULT ConfigDialogEdit(
  [in]  HWND  hwndOwner,
  [in]  BSTR  pDeviceClass,
  [in]  DWORD dwSizeIn,
  [in]  BYTE  *pDeviceConfigIn,
  [out] DWORD *pdwSizeOut,
  [out] BYTE  **ppDeviceConfigOut
);

参数

[in] hwndOwner

对话框要附加到的窗口的句柄。 可以为 NULL ,以指示方法创建的窗口应没有所有者窗口。

[in] pDeviceClass

指向指定设备类名称的 BSTR 的指针。 此设备类允许应用程序选择适用于该设备类的配置信息的特定子屏幕。 此参数是可选的,可以保留 NULL 或空,在这种情况下,会选择最高级别的配置。

[in] dwSizeIn

指向 pDeviceConfigIn 参数所指向的配置数据大小的指针。

[in] pDeviceConfigIn

指向包含要编辑的设备配置数据的字节数组的指针。

[out] pdwSizeOut

指向 ppDeviceConfigOut 参数所指向的配置数据大小的指针。

[out] ppDeviceConfigOut

指向包含已编辑设备配置数据的字节数组的指针。

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法转换为 TAPI 2。xlineConfigDialogEdit 调用。 ITLegacyAddressMediaControl2::ConfigDialog 方法转换为 lineConfigDialog 调用。 这些方法在要编辑的参数源和活动连接上的编辑结果上有所不同。 有关这些差异的讨论,请参阅 lineConfigDialogEdit

要求

要求
目标平台 Windows
标头 tapi3if.h
Library Uuid.lib
DLL Tapi3.dll

另请参阅

ITLegacyAddressMediaControl2

ITLegacyAddressMediaControl2::ConfigDialog