Método ITLegacyCallMediaControl2::GatherDigits (tapi3if.h)

El método GatherDigits inicia la recopilación de dígitos en la llamada especificada. La aplicación especifica el número máximo de dígitos que se van a recopilar.

Sintaxis

HRESULT GatherDigits(
  [in] TAPI_DIGITMODE DigitMode,
  [in] long           lNumDigits,
  [in] BSTR           pTerminationDigits,
  [in] long           lFirstDigitTimeout,
  [in] long           lInterDigitTimeout
);

Parámetros

[in] DigitMode

Los modos de dígito que se van a supervisar. Este parámetro especifica una o varias de las constantes LINEDIGITMODE .

[in] lNumDigits

Número de dígitos que se van a recopilar.

Si este parámetro es cero, el método cancela cualquier recopilación de dígitos en curso, sin iniciar un nuevo intento de recopilación de dígitos. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[in] pTerminationDigits

Puntero a una representación BSTR de los dígitos de terminación. Si se detecta uno de los dígitos de terminación de la cadena, ese dígito se anexa al búfer, se finaliza la colección de dígitos y el evento TE_GATHERDIGITS se envía a la aplicación.

[in] lFirstDigitTimeout

El período de tiempo, en milisegundos, durante el cual se espera el primer dígito. Si el primer dígito no se recibe en este período de tiempo, se anula la recopilación de dígitos y se envía un evento TE_GATHERDIGITS a la aplicación. El búfer contiene solo el carácter NULL , lo que indica que no se recibieron dígitos y que la recopilación de dígitos finalizó por primera vez. Los tiempos de espera mínimos y máximos que puede especificar se encuentran en las funcionalidades de AC_GATHERDIGITSMINTIMEOUT y AC_GATHERDIGITSMAXTIMEOUT.

[in] lInterDigitTimeout

Tiempo máximo, en milisegundos, entre dígitos consecutivos. Si el siguiente dígito no se recibe en este período de tiempo, se anula la recopilación de dígitos y se envía un evento TE_GATHERDIGITS a la aplicación. El búfer contiene solo los dígitos recopilados hasta este punto seguido de un carácter NULL , lo que indica que un tiempo de espera interdigit finalizó la recopilación de dígitos. Los tiempos de espera mínimos y máximos que se pueden especificar se encuentran en las funcionalidades de AC_GATHERDIGITSMINTIMEOUT y AC_GATHERDIGITSMAXTIMEOUT.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_POINTER	El parámetro pTerminationDigits no es un puntero válido.
E_OUTOFMEMORY	No hay suficiente memoria para asignar el búfer de dígitos de recopilación.
TAPI_E_INVALCALLSTATE	La llamada debe estar en el estado conectado .

Comentarios

El método GatherDigits se traduce en una llamada al TAPI 2. Función xlineGatherDigits .

Solo una llamada a GatherDigits puede ser pendiente en una llamada. Si llama a GatherDigits de nuevo, antes de que se haya producido el evento TE_GATHERDIGITS , la segunda llamada cancela la recopilación anterior de dígitos. Los intentos cancelados de recopilación de dígitos envían un evento de TE_GATHERDIGITS con los dígitos recopilados hasta ahora.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi3if.h
Library	Uuid.lib
Archivo DLL	Tapi3.dll

Consulte también

ITLegacyCallMediaControl2