lineMonitorDigits 함수(tapi.h)

아티클
08/26/2023

lineMonitorDigits 함수는 호출 시 수신된 숫자의 버퍼링되지 않은 검색을 사용하도록 설정하고 사용하지 않도록 설정합니다. 지정된 숫자 모드의 숫자가 검색될 때마다 검색된 숫자를 나타내는 메시지가 애플리케이션으로 전송됩니다.

구문

LONG lineMonitorDigits(
  HCALL hCall,
  DWORD dwDigitModes
);

매개 변수

hCall

검색할 숫자를 호출하는 핸들입니다. hCall의 호출 상태는 유휴 상태 또는 연결 끊김을 제외한 모든 상태일 수 있습니다.

dwDigitModes

모니터링할 숫자 모드 또는 모드입니다. dwDigitModes가 0이면 숫자 모니터링이 취소됩니다. 이 매개 변수는 하나 이상의 LINEDIGITMODE_ 상수를 사용합니다.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALDIGITMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

설명

이 함수는 숫자 모니터링이 종료된 시점이 아니라 숫자 모니터링이 올바르게 시작된 경우 성공한 것으로 간주됩니다. dwDigitModes가 0으로 설정된 lineMonitorDigits를 호출하거나, 호출이 유휴 상태로 전환되거나, 애플리케이션이 호출에 대한 호출 핸들의 할당을 취소할 때까지 숫자 모니터링은 명시적으로 비활성화될 때까지 계속 적용됩니다. 이 함수는 모든 호출 상태에서 호출할 수 있지만 일반적으로 호출이 연결된 상태인 동안에만 숫자가 검색됩니다.

숫자가 검색될 때마다 검색된 숫자를 매개 변수로 전달하는 애플리케이션에 LINE_MONITORDIGITS 메시지가 전송됩니다.

애플리케이션은 lineMonitorDigits 를 사용하여 버퍼링되지 않은 숫자 검색을 사용하거나 사용하지 않도록 설정할 수 있습니다. 버퍼링된 숫자 검색에 lineGatherDigits 를 사용할 수 있습니다. 버퍼링된 숫자 수집이 완료되면 LINE_GATHERDIGITS 메시지가 애플리케이션으로 전송됩니다. 버퍼링된 숫자와 버퍼링되지 않은 숫자 검색은 동일한 호출에서 동시에 사용하도록 설정할 수 있습니다.

전화 회의 통화의 숫자 모니터링은 개별 참여 통화가 아닌 hConfCall에만 적용됩니다.