lineDeallocateCall 함수(tapi.h)
lineDeallocateCall 함수는 지정된 호출 핸들의 할당을 취소합니다.
LONG lineDeallocateCall(
HCALL hCall
);
hCall
할당 취소할 호출 핸들입니다. 호출에 대한 모니터링 권한이 있는 애플리케이션은 항상 해당 호출에 대한 핸들의 할당을 취소할 수 있습니다. 호출에 대한 소유자 권한이 있는 애플리케이션은 호출의 유일한 소유자이고 호출이 유휴 상태가 아닌 한 해당 핸들의 할당을 취소할 수 있습니다. 호출 핸들이 할당 취소된 후 더 이상 유효하지 않습니다.
요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.
할당 취소는 실제 호출의 호출 상태에 영향을 주지 않습니다. 그러나 호출과 관련된 내부 리소스를 해제합니다.
2.0 이전의 API 버전에서 애플리케이션이 호출의 유일한 소유자이고 호출이 유휴 상태가 아닌 경우 LINEERR_INVALCALLSTATE 반환됩니다. 이 경우 애플리케이션은 먼저 lineDrop 을 사용하여 호출을 삭제하고 나중에 호출 핸들의 할당을 취소할 수 있습니다. 호출에 대한 모니터 권한이 있는 애플리케이션은 항상 호출에 대한 핸들의 할당을 취소할 수 있습니다.
API 버전 2.0 이상에서 호출의 유일한 소유자는 호출이 유휴 상태가 아니더라도 해당 핸들의 할당을 취소할 수 있습니다. 이렇게 하면 클라이언트/서버 환경에서 호출을 분산 제어할 수 있습니다.
API 버전 2.0 이상에서 lineDeallocateCall 은 미해결 LINE_REPLY 메시지를 일시 중단하지 않습니다. 애플리케이션에 dwRequestID 를 반환하는 모든 비동기 함수는 애플리케이션이 lineShutdown을 호출하지 않는 한 항상 연결된 LINE_REPLY 메시지를 전달합니다.
대상 플랫폼 | Windows |
헤더 | tapi.h |
라이브러리 | Tapi32.lib |
DLL | Tapi32.dll |