TSPI_lineDrop 함수(tspi.h)
TSPI_lineDrop 함수는 지정된 호출을 삭제하거나 연결을 끊습니다. 사용자-사용자 정보는 필요에 따라 통화 연결 끊기의 일부로 전송될 수 있습니다. 이 함수는 언제든지 애플리케이션에서 호출할 수 있습니다. TSPI_lineDrop 반환되면 호출이 유휴 상태여야 합니다.
구문
LONG TSPIAPI TSPI_lineDrop(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCSTR lpsUserUserInfo,
DWORD dwSize
);
매개 변수
dwRequestID
비동기 요청의 식별자입니다.
hdCall
삭제할 호출에 대한 서비스 공급자의 핸들입니다. hdCall의 호출 상태는 유휴 상태를 제외한 모든 상태일 수 있습니다.
lpsUserUserInfo
이 포인터는 dwSize 가 0이 아닌 경우에만 유효합니다. 호출 연결 끊기의 일부로 원격 당사자에게 보낼 사용자-사용자 정보를 포함하는 null로 종료된 문자열에 대한 포인터를 지정합니다. 이 포인터는 전송할 사용자-사용자 정보가 없는 경우 NULL 입니다. 사용자-사용자 정보는 기본 네트워크에서 지원하는 경우에만 전송 됩니다(LINEDEVCAPS 참조).
dwSize
lpsUserUserInfo의 사용자-사용자 정보의 크기(바이트)입니다. lpsUserUserInfo가 NULL이면 dwSize는 무시됩니다.
반환 값
오류가 발생하면 dwRequestID 또는 오류 번호를 반환합니다. 해당 ASYNC_COMPLETIONlResult 실제 매개 변수는 함수가 성공하면 0이거나 오류가 발생하면 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.
설명
호출의 현재 상태가 호출을 삭제할 수 없는 경우 서비스 공급자는 LINEERR_INVALCALLSTATE 반환합니다.
TSPI_lineDrop 호출할 때 관련 호출도 영향을 받을 수 있습니다. 예를 들어 전화 회의를 삭제하면 모든 개별 참여 통화가 삭제할 수 있습니다. LINE_CALLSTATE 메시지는 호출 상태가 영향을 받는 모든 호출에 대해 TAPI로 전송됩니다. 일반적으로 삭제된 호출은 유휴 상태로 전환됩니다. 제공 상태의 호출에서 TSPI_lineDrop 호출하면 호출이 거부됩니다. 모든 전화 네트워크에서 이 기능을 제공하는 것은 아닙니다.
통화가 전송 또는 전화 회의 설정 중에 설정된 상담 통화인 경우 OnHoldPending 상태에 배치된 원래 통화가 다시 연결되고 일반적으로 연결된 통화 상태로 다시 입력됩니다.
TAPI에는 드롭 시 사용자-사용자 정보를 보낼 수 있는 옵션이 있습니다. 사용자-사용자 정보를 보낼 수 있더라도 네트워크에서 이 정보를 원격 당사자에게 전달한다는 보장은 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | tspi.h |