ITLegacyCallMediaControl：：GetID 方法 (tapi3if.h)

GetID 方法获取与当前调用关联的设备的标识符。

此方法适用于 C/C++ 应用程序。 Visual Basic 和脚本应用程序应使用 ITLegacyCallMediaControl2：：GetIDAsVariant 方法。

语法

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

[in] pDeviceClass

指向表示 TAPI 设备类的 BSTR 的指针。

[out] pdwSize

设备标识符的大小（以字节为单位）。

[out] ppDeviceID

设备标识符。

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

返回代码	说明
S_OK	方法成功。
E_OUTOFMEMORY	内存不足，无法执行操作。
E_POINTER	pdwSize 或 ppDeviceID 参数不是有效的指针。

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

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

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