Método ITLegacyAddressMediaControl::GetID (tapi3if.h)

Artículo
03/13/2024

El método GetID devuelve un identificador de dispositivo para la clase de dispositivo especificada asociada a la dirección actual.

Este método está pensado solo para aplicaciones de C/C++. No hay ningún método correspondiente disponible para Visual Basic y aplicaciones de scripting.

Sintaxis

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

Parámetros

[in] pDeviceClass

Puntero a BSTR que contiene la clase de dispositivo TAPI para la que se necesita información de configuración.

[out] pdwSize

Longitud del identificador de dispositivo devuelto.

[out] ppDeviceID

Identificador de dispositivo.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_FAIL	Error en el método. Esto puede significar que no hay ningún dispositivo de una clase especificada asociada a la dirección actual.
E_POINTER	El parámetro pdwSize o ppDeviceID no es un puntero válido.

Comentarios

La aplicación debe llamar a ITTAPI::RegisterCallNotifications antes de llamar a este método.

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pDeviceClass y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

La aplicación debe llamar a la función CoTaskMemFree para liberar la memoria asignada para el parámetro ppDeviceID .

Referencias cruzadas de TAPI 2.1: lineGetDevConfig, lineSetDevConfig, lineGetID