TSPI_lineDial 함수(tspi.h)
TSPI_lineDial 함수는 지정된 통화에서 지정된 전화 걸기 가능 번호로 전화를 켭니다.
구문
LONG TSPIAPI TSPI_lineDial(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
매개 변수
dwRequestID
비동기 요청의 식별자입니다.
hdCall
전화를 걸 호출에 대한 서비스 공급자의 핸들입니다. hdCall의 호출 상태는 유휴 상태와 연결 끊김을 제외한 모든 상태일 수 있습니다.
lpszDestAddress
표준 전화 걸기 가능 번호 형식을 사용하여 전화를 걸 대상을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
dwCountryCode
대상의 국가 또는 지역 코드입니다. 구현에서는 이를 사용하여 대상 주소에 대한 호출 진행률 프로토콜을 선택합니다. 값 0을 지정하면 서비스 공급자가 정의한 기본 호출 진행률 프로토콜이 사용됩니다. TAPI는 이 함수가 호출되면 이 매개 변수의 유효성을 검사하지 않습니다.
반환 값
오류가 발생하면 dwRequestID 또는 오류 번호를 반환합니다. 함수가 성공하면 해당 ASYNC_COMPLETIONlResult 실제 매개 변수는 0이거나 오류가 발생할 경우 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCOUNTRYCODE, LINEERR_DIALBILLING, LINEERR_INVALCALLSTATE, LINEERR_DIALQUIET, LINEERR_ADDRESSBLOCKED, LINEERR_DIALDIALTONE, LINEERR_NOMEM, LINEERR_DIALPROMPT, LINEERR_OPERATIONUNAVAIL.
설명
호출의 현재 상태가 전화 걸기를 허용하지 않는 경우 서비스 공급자는 LINEERR_INVALCALLSTATE 반환합니다.
서비스 공급자는 LINEERR_INVALADDRESS 반환하는 경우 전화를 걸지 않습니다.
서비스 공급자가 LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE 또는 LINEERR_DIALPROMPT 반환하는 경우 TSPI_lineDial 수행하지 않는 작업(예: 부분 전화 걸기 및 오프후크 없음)을 수행하지 않아야 합니다. 서비스 공급자가 먼저 지원되지 않는 문자 수를 미리 검사해야 하므로 이 때문입니다.
TSPI_lineDial 기존 통화 모양으로 전화를 걸 때 사용됩니다. 예를 들어 nULL을 lpszDestAddress로 사용하거나 ';'로 끝나는 TSPI_lineMakeCall 반환된 호출 핸들, TSPI_lineSetupTransfer 또는 TSPI_lineSetupConference 반환된 호출 핸들입니다. TSPI_lineDial 회선의 디바이스 기능이 허용하는 경우 다단계 전화 걸기의 경우 전화 걸기 과정에서 여러 번 호출할 수 있습니다.
TSPI_lineMakeCall 또는 TSPI_lineDial 함수에 대한 이전 호출에서 lpszDestAddress 매개 변수가 가리키는 문자열이 세미콜론으로 종료되는 경우 TSPI_lineDial 대한 현재 호출에서 빈 문자열은 전화 걸기를 완료했음을 나타냅니다.
CRLF로 구분된 단일 다이얼 문자열로 여러 주소를 제공할 수 있습니다. 역 멀티플렉싱을 제공하는 서비스 공급자는 각 주소로 개별 물리적 호출을 설정하고 애플리케이션에 대한 모든 호출의 집계에 단일 호출 핸들을 반환할 수 있습니다. 모든 주소는 동일한 국가 또는 지역 코드를 사용합니다.
전화 걸기는 통화가 마지막으로 연결된 후가 아니라 서비스 공급자가 주소를 수락한 후 완료된 것으로 간주됩니다. 역 멀티플렉싱을 제공하는 서비스 공급자는 한 번에 여러 주소를 제공할 수 있습니다. 서비스 공급자는 TAPI에 LINE_CALLSTATE 메시지를 보내 호출 진행 상황을 알려야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | tspi.h |