Метод 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
Идентификатор устройства.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Код возврата | Описание |
---|---|
|
Метод успешно выполнен. |
|
Сбой метода. Это может означать отсутствие устройства указанного класса, связанного с текущим адресом. |
|
Параметр 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 |