TSPI_lineCloseCall 함수(tspi.h)
TSPI_lineCloseCall 함수는 호출에 대한 모든 미해결 비동기 작업을 완료하거나 중단한 후 호출의 할당을 취소합니다.
구문
LONG TSPIAPI TSPI_lineCloseCall(
HDRVCALL hdCall
);
매개 변수
hdCall
닫을 호출에 대한 서비스 공급자의 핸들입니다. 호출이 성공적으로 닫힌 후에는 이 핸들이 더 이상 유효하지 않습니다. 호출 상태는 모든 상태일 수 있습니다.
반환 값
함수가 성공하면 0을 반환하고 오류가 발생하면 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.
설명
서비스 공급자는 비동기 작업에 대한 완료를 보고해야 합니다. 미해결 비동기 작업이 있는 호출에 대해 TSPI_lineCloseCall 호출되면 이 프로시저가 반환되기 전에 적절한 결과 또는 오류 코드로 작업이 완료된 것으로 보고되어야 합니다. 이 프로시저가 반환되면 서비스 공급자는 호출에 대해 더 이상 이벤트를 보고하지 않아야 합니다. 줄에 대한 서비스 공급자의 핸들과 줄의 호출은 "유효하지 않습니다."가 됩니다.
서비스 공급자가 TSPI_lineMakeCall 함수에 대한 호출에서 오류를 동기적으로 반환하는 경우 TAPI는 TSPI_lineCloseCall 호출하지 않습니다. 그러나 서비스 공급자가 TSPI_lineMakeCall 시작한 비동기 작업에서 오류를 반환하는 경우 TAPI는 TSPI_lineCloseCall 호출합니다.
TSPI_lineCloseCall 때 줄에 활성 호출이 있는 경우 이 동작이 LINEDEVCAPS 구조의 LINEDEVCAPFLAGS_CLOSEDROP 비트로 표시되는 경우 호출을 삭제해야 합니다.
서비스 공급자가 별도의 핸드셋이 있는 파티 라인 상황과 같이 통화에 대한 다른 에이전트 공유 제어가 있는지 확인할 수 있는 경우 서비스 공급자는 강제로 삭제하는 대신 다른 에이전트에 대한 호출 패스를 제어할 수 있습니다.
이 함수는 특별한 경우를 제외하고 항상 성공해야 합니다. 대부분의 호출자는 발생하는 오류를 보상할 수 없으므로 반환 코드를 무시할 수 있습니다. 지정된 반환 값은 개발 진단 목적으로 무엇보다 권고가 더 큽니다.
이 함수는 이 호출에 대한 핸들이 있는 마지막 애플리케이션이 lineDeallocateCall을 실행할 때 호출됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |