Función lineGetAddressStatus (tapi.h)

La función lineGetAddressStatus permite a una aplicación consultar la dirección especificada para su estado actual.

Sintaxis

LONG lineGetAddressStatus(
  HLINE               hLine,
  DWORD               dwAddressID,
  LPLINEADDRESSSTATUS lpAddressStatus
);

Parámetros

hLine

Controle el dispositivo de línea abierta.

dwAddressID

Dirección en el dispositivo de línea abierta especificado. Esta es la dirección que se va a consultar. Un identificador de dirección está asociado permanentemente a una dirección; el identificador permanece constante en las actualizaciones del sistema operativo.

lpAddressStatus

Puntero a una estructura de datos de tamaño variably de tipo LINEADDRESSSTATUS. Antes de llamar a lineGetAddressStatus, 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_INVALADDRESSID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi.h
Library	Tapi32.lib
Archivo DLL	Tapi32.dll

Consulte también

Referencia de servicios de telefonía básica

LINEADDRESSSTATUS

Introducción a la referencia de TAPI 2.2