Función lineGetAddressID (tapi.h)

Artículo
03/05/2024

La función lineGetAddressID devuelve el identificador de dirección asociado a una dirección en un formato diferente en la línea especificada.

Sintaxis

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

Parámetros

hLine

Controle el dispositivo de línea abierta.

lpdwAddressID

Puntero a una ubicación de memoria de tamaño DWORD donde se devuelve el identificador de dirección. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

dwAddressMode

Modo de dirección de la dirección contenida en lpsAddress. Este parámetro usa una y solo una de las LINEADDRESSMODE_ Constantes. Debe especificar LINEADDRESSMODE_DIALABLEADDR.

lpsAddress

Puntero a una estructura de datos que contiene la dirección asignada al dispositivo de línea especificado. El formato de la dirección viene determinado por dwAddressMode. Dado que el único valor válido es LINEADDRESSMODE_DIALABLEADDR, lpsAddress usa el formato de número de marcado común y termina en null.

dwSize

Tamaño, en bytes, de la dirección contenida en lpsAddress. El tamaño de la cadena debe incluir el terminador NULL.

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_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Comentarios

La función lineGetAddressID se usa para asignar un número de teléfono (dirección) asignado a un dispositivo de línea a su dwAddressID en el intervalo cero al número de direcciones menos una devuelta en las funcionalidades del dispositivo de la línea. La función lineMakeCall permite a la aplicación realizar una llamada especificando un identificador de línea y una dirección en la línea. La dirección se puede especificar como dwAddressID, como un número de teléfono o como un nombre o identificador específicos del dispositivo. El uso de un número de teléfono puede ser práctico en entornos en los que se asignan varias direcciones a una sola línea.

Nota es posible que no se use LINEADDRESSMODE_ADDRESSID con lineGetAddressID.