ITLegacyCallMediaControl2::GatherDigits-Methode (tapi3if.h)

Artikel
03/02/2024

Die GatherDigits-Methode initiiert das Sammeln von Ziffern für den angegebenen Aufruf. Die Anwendung gibt die maximale Anzahl der zu erfassenden Ziffern an.

Syntax

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

Parameter

[in] DigitMode

Die zu überwachenden Ziffernmodi. Dieser Parameter gibt eine oder mehrere der LINEDIGITMODE-Konstanten an.

[in] lNumDigits

Die Anzahl der zu erfassenden Ziffern.

Wenn dieser Parameter null ist, bricht die Methode alle laufenden Ziffernsammlungen ab, ohne einen neuen Versuch zum Sammeln von Ziffern zu starten. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in] pTerminationDigits

Zeiger auf eine BSTR-Darstellung der Abschlussziffern. Wenn eine der Abschlussziffern in der Zeichenfolge erkannt wird, wird diese Ziffer an den Puffer angefügt, die Ziffernsammlung wird beendet, und das TE_GATHERDIGITS Ereignis wird an die Anwendung gesendet.

[in] lFirstDigitTimeout

Die Zeitdauer in Millisekunden, in der die erste Ziffer erwartet wird. Wenn die erste Ziffer in diesem Zeitrahmen nicht empfangen wird, wird die Ziffernsammlung abgebrochen, und ein TE_GATHERDIGITS-Ereignis wird an die Anwendung gesendet. Der Puffer enthält nur das NULL-Zeichen , das angibt, dass keine Ziffern empfangen wurden und dass das Erste-Ziffern-Timeout das Sammeln von Ziffern beendet hat. Die minimalen und maximalen Timeouts, die Sie angeben können, finden Sie in den Funktionen AC_GATHERDIGITSMINTIMEOUT und AC_GATHERDIGITSMAXTIMEOUT.

[in] lInterDigitTimeout

Die maximale Zeit in Millisekunden zwischen aufeinanderfolgenden Ziffern. Wenn die nächste Ziffer in diesem Zeitrahmen nicht empfangen wird, wird die Ziffernsammlung abgebrochen, und ein TE_GATHERDIGITS Ereignis wird an die Anwendung gesendet. Der Puffer enthält nur die bis zu diesem Punkt gesammelten Ziffern, gefolgt von einem NULL-Zeichen , das angibt, dass ein Interdigit-Timeout die Ziffernsammlung beendet hat. Die minimalen und maximalen Timeouts, die angegeben werden können, finden Sie in den Funktionen AC_GATHERDIGITSMINTIMEOUT und AC_GATHERDIGITSMAXTIMEOUT.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_POINTER	Der Parameter pTerminationDigits ist kein gültiger Zeiger.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Puffer zum Sammeln von Ziffern zuzuordnen.
TAPI_E_INVALCALLSTATE	Der Aufruf muss sich im Zustand verbunden befinden.

Hinweise

Die GatherDigits-Methode wird in einen Aufruf von TAPI 2 übersetzt. xlineGatherDigits-Funktion .

Nur ein GatherDigits-Aufruf kann für einen Anruf ausstehend sein. Wenn Sie GatherDigits erneut aufrufen, bevor das TE_GATHERDIGITS-Ereignis aufgetreten ist, bricht der zweite Aufruf die vorherige Erfassung von Ziffern ab. Abgebrochene Ziffernsammlungsversuche senden ein TE_GATHERDIGITS-Ereignis mit den bisher gesammelten Ziffern.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tapi3if.h
Bibliothek	Uuid.lib
DLL	Tapi3.dll

Weitere Informationen

ITLegacyCallMediaControl2

Freigeben über