TSPI_lineGetAddressID función (tspi.h)
La función TSPI_lineGetAddressID devuelve el identificador de dirección asociado a la dirección en un formato diferente en la línea especificada.
Sintaxis
LONG TSPIAPI TSPI_lineGetAddressID(
HDRVLINE hdLine,
LPDWORD lpdwAddressID,
DWORD dwAddressMode,
LPCWSTR lpsAddress,
DWORD dwSize
);
Parámetros
hdLine
Identificador del proveedor de servicios a la línea cuya dirección se va a recuperar.
lpdwAddressID
Puntero a una ubicación de memoria de tamaño DWORD donde se devuelve el identificador de dirección.
dwAddressMode
Modo de dirección de la dirección contenida en lpsAddress. El parámetro dwAddressMode puede tener una y solo una de las constantes LINEADDRESSMODE_.
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 el parámetro dwAddressMode . Si se LINEADDRESSMODE_DIALABLEADDR, el parámetro lpsAddress usa el formato de número de marcado común y termina NULL .
dwSize
Tamaño de la dirección contenida en lpsAddress. El parámetro dwSize debe establecerse en la longitud de la cadena (más una para null) si se usa LINEADDRESSMODE_DIALABLEADDR. Si se usa una LÍNEADDRESSMODE extendida, la longitud debe coincidir con el tamaño de lo que realmente se pasa (el archivo DLL comprueba que puede leer el número de bytes especificados desde el puntero especificado).
Valor devuelto
Devuelve cero si la función se realiza correctamente o si se produce un error. Los valores devueltos posibles son los siguientes:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Comentarios
Esta función 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 comprendido entre 0 y el número de direcciones menos uno) que se devuelve en las funcionalidades del dispositivo de la línea.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tspi.h |