Compartir a través de

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

  • Artículo

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 .

Requisitos

   
Plataforma de destino Windows
Encabezado tapi3if.h (incluya Tapi3.h)
Library Uuid.lib
Archivo DLL Tapi3.dll

Consulte también

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

ITLegacyCallMediaControl2::GetIDAsVariant