Función lineGetAddressCaps (tapi.h)

Artículo
03/05/2024

La función lineGetAddressCaps consulta la dirección especificada en el dispositivo de línea especificado para determinar sus funcionalidades de telefonía.

Sintaxis

LONG lineGetAddressCaps(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Parámetros

hLineApp

Controle el registro de la aplicación con TAPI.

dwDeviceID

Dispositivo de línea que contiene la dirección que se va a consultar.

dwAddressID

Dirección en el dispositivo de línea determinado cuyas funcionalidades se van a consultar. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

dwAPIVersion

Número de versión de la API de telefonía que se va a usar. La palabra de orden superior contiene el número de versión principal; la palabra de orden bajo contiene el número de versión secundaria. Este número se obtiene mediante lineNegotiateAPIVersion.

dwExtVersion

Número de versión de las extensiones específicas del proveedor de servicios que se van a usar. Este número se puede establecer en cero si no se va a usar ninguna extensión específica del dispositivo. De lo contrario, la palabra de orden superior contiene el número de versión principal; y la palabra de orden bajo contiene el número de versión secundaria.

lpAddressCaps

Puntero a una estructura de tamaño variable de tipo LINEADDRESSCAPS. Una vez completada correctamente la solicitud, esta estructura se rellena con información de funcionalidades de dirección. Antes de llamar a lineGetAddressCaps, la aplicación debe establecer el miembro dwTotalSize de esta estructura para indicar la cantidad de memoria disponible para TAPI para devolver información.

Nota Si los parámetros de tamaño de la estructura no son correctos, existe la posibilidad de que se sobrescriban los datos. Para obtener más información sobre cómo establecer tamaños de estructura, consulte el tema de asignación de memoria .

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALAPPHANDLE, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_NODEVICE.

Comentarios

Los identificadores de dirección válidos van de cero a uno menor que el número de direcciones devueltas por lineGetDevCaps. El número de versión que se va a proporcionar es el número de versión que se devolvió como parte de las funcionalidades del dispositivo de la línea por lineGetDevCaps.