다음을 통해 공유

ITLegacyCallMediaControl2::GatherDigits 메서드(tapi3if.h)

  • 아티클

GatherDigits 메서드는 지정된 호출에서 숫자 수집을 시작합니다. 애플리케이션은 수집할 최대 자릿수를 지정합니다.

구문

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

매개 변수

[in] DigitMode

모니터링할 숫자 모드입니다. 이 매개 변수는 LINEDIGITMODE 상수 중 하나 이상을 지정합니다.

[in] lNumDigits

수집할 숫자 수입니다.

이 매개 변수가 0이면 메서드는 새 숫자 수집 시도를 시작하지 않고 진행 중인 모든 숫자 수집을 취소합니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

[in] pTerminationDigits

종료 숫자의 BSTR 표현에 대한 포인터입니다. 문자열의 종료 숫자 중 하나가 검색되면 해당 숫자가 버퍼에 추가되고, 숫자 컬렉션이 종료되고, TE_GATHERDIGITS 이벤트가 애플리케이션으로 전송됩니다.

[in] lFirstDigitTimeout

첫 번째 숫자가 예상되는 시간(밀리초)입니다. 이 기간에 첫 번째 숫자를 받지 못하면 숫자 컬렉션이 중단되고 TE_GATHERDIGITS 이벤트가 애플리케이션으로 전송됩니다. 버퍼에는 숫자가 수신되지 않았으며 첫 번째 숫자 시간 제한이 숫자 수집을 종료했음을 나타내는 NULL 문자만 포함됩니다. 지정할 수 있는 최소 및 최대 시간 제한은 AC_GATHERDIGITSMINTIMEOUT 및 AC_GATHERDIGITSMAXTIMEOUT 기능에 있습니다.

[in] lInterDigitTimeout

연속된 숫자 사이의 최대 시간(밀리초)입니다. 이 기간에 다음 숫자를 받지 못하면 숫자 컬렉션이 중단되고 TE_GATHERDIGITS 이벤트가 애플리케이션으로 전송됩니다. 버퍼에는 이 시점까지 수집된 숫자와 NULL 문자만 포함되며, 이는 interdigit-timeout이 숫자 수집을 종료했음을 나타냅니다. 지정할 수 있는 최소 및 최대 시간 제한은 AC_GATHERDIGITSMINTIMEOUT 및 AC_GATHERDIGITSMAXTIMEOUT 기능에 있습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 메서드가 정상적으로 실행되었습니다.
E_POINTER
 pTerminationDigits 매개 변수가 유효한 포인터가 아닙니다.
E_OUTOFMEMORY
 수집 숫자 버퍼를 할당할 메모리가 부족합니다.
TAPI_E_INVALCALLSTATE
 호출이 연결된 상태여야 합니다.

설명

GatherDigits 메서드는 TAPI 2에 대한 호출로 변환됩니다. xlineGatherDigits 함수입니다.

하나의 GatherDigits 호출만 호출에서 미해결될 수 있습니다. GatherDigits를 다시 호출하는 경우 TE_GATHERDIGITS 이벤트가 발생하기 전에 두 번째 호출은 이전 숫자 수집을 취소합니다. 취소된 숫자 수집 시도는 지금까지 수집된 숫자와 함께 TE_GATHERDIGITS 이벤트를 보냅니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi3if.h
라이브러리 Uuid.lib
DLL Tapi3.dll

추가 정보

ITLegacyCallMediaControl2