itLegacyAddressMediaControl：：GetID 方法 (tapi3if.h)

GetID 方法返回与当前地址关联的指定设备类的设备标识符。

此方法仅适用于 C/C++ 应用程序。没有适用于 Visual Basic 和脚本应用程序的相应方法。

语法

HRESULT GetID(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceID
);

[in] pDeviceClass

指向包含需要配置信息的 TAPI 设备类的 BSTR 的指针。

[out] pdwSize

返回的设备标识符的长度。

[out] ppDeviceID

设备标识符。

此方法可以返回其中一个值。

返回代码	说明
S_OK	方法成功。
E_FAIL	方法失败。这可能意味着没有与当前地址关联的指定类的设备。
E_POINTER	pdwSize 或 ppDeviceID 参数不是有效的指针。

在调用此方法之前，应用程序必须调用 ITTAPI：：RegisterCallNotifications 。

应用程序必须使用 SysAllocString 为 pDeviceClass 参数分配内存，并在不再需要变量时使用 SysFreeString 释放内存。

应用程序必须调用 CoTaskMemFree 函数来释放为 ppDeviceID 参数分配的内存。

TAPI 2.1 交叉引用： lineGetDevConfig、 lineSetDevConfig、 lineGetID