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

Статья
08/26/2023

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

Этот метод предназначен для приложений C/C++. Visual Basic и приложения сценариев должны использовать метод ITLegacyCallMediaControl2::GetIDAsVariant .

Синтаксис

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

Параметры

[in] pDeviceClass

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

[out] pdwSize

Размер идентификатора устройства в байтах.

[out] ppDeviceID

Идентификатор устройства.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Метод успешно выполнен.
E_OUTOFMEMORY	Для выполнения операции недостаточно памяти.
E_POINTER	Параметр pdwSize или ppDeviceID не является допустимым указателем.

Приложение должно использовать SysAllocString для выделения памяти для параметра pDeviceClass и использовать SysFreeString для освобождения памяти, когда переменная больше не нужна.

Приложение должно вызвать функцию CoTaskMemFree , чтобы освободить память, выделенную для параметра ppDeviceID .