Función lineGetAgentStatusA (tapi.h)

  • Artículo

La función lineGetAgentStatus obtiene el estado relacionado con el agente en la dirección especificada.

Sintaxis

LONG lineGetAgentStatusA(
  HLINE             hLine,
  DWORD             dwAddressID,
  LPLINEAGENTSTATUS lpAgentStatus
);

Parámetros

hLine

Controle el dispositivo de línea abierta.

dwAddressID

Dirección en el dispositivo de línea abierta cuyo estado del agente 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.

lpAgentStatus

Puntero a una estructura de tamaño variable de tipo LINEAGENTSTATUS. Una vez completada correctamente la solicitud, esta estructura se rellena con información de estado del agente. Antes de llamar a lineGetAgentStatus, 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 sobrescriba la memoria. 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 un identificador de solicitud positivo si se inicia la operación asincrónica; de lo contrario, uno de estos valores de error negativos:

LINEERR_INVALADDRESSID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Comentarios

Nota

El encabezado tapi.h define lineGetAgentStatus 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 Convenciones para prototipos de función.

Requisitos

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

Consulte también

LINEAGENTSTATUS

Funciones complementarias del servicio de línea

Introducción a la referencia de TAPI 2.2