Поделиться через


Метод ITLegacyAddressMediaControl::GetID (tapi3if.h)

Метод GetID возвращает идентификатор устройства для указанного класса устройства, связанного с текущим адресом.

Этот метод предназначен только для приложений C/C++. Для Visual Basic и приложений скриптов нет соответствующего метода.

Синтаксис

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

Параметры

[in] pDeviceClass

Указатель на BSTR , содержащий класс устройства TAPI , для которого требуются сведения о конфигурации.

[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

Требования

Требование Значение
Целевая платформа Windows
Header tapi3if.h (включая Tapi3.h)
Библиотека Uuid.lib
DLL Tapi3.dll

См. также раздел

GetDevConfig

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig