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

Artículo
03/08/2023

El método GetID obtiene el identificador del dispositivo asociado a la llamada actual.

Este método está diseñado para aplicaciones de C/C++. Las aplicaciones de Visual Basic y scripting deben usar el método ITLegacyCallMediaControl2::GetIDAsVariant .

Sintaxis

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

Parámetros

[in] pDeviceClass

Puntero a BSTR que representa la clase de dispositivo TAPI.

[out] pdwSize

Tamaño en bytes del identificador del dispositivo.

[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_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
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 .