Función lineGetAddressIDW (tapi.h)

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 lineGetAddressIDW(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCWSTR lpsAddress,
  DWORD   dwSize
);

Parámetros

hLine

Controle el dispositivo de línea abierta.

lpdwAddressID

Puntero a un DWORDubicación de memoria de tamaño 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 constantes de LINEADDRESSMODE_. 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 está terminado 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.

Observaciones

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 un 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 asigna varias direcciones a una sola línea.

Nota LINEADDRESSMODE_ADDRESSID no se puede usar con lineGetAddressID.

 

Nota

El encabezado tapi.h define lineGetAddressID como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	tapi.h
biblioteca de	Tapi32.lib
DLL de	Tapi32.dll

Consulte también

referencia de servicios de telefonía básica de

de información general de referencia de TAPI 2.2

lineMakeCall