lineGetCallStatus 함수(tapi.h)

아티클
03/08/2023

lineGetCallStatus 함수는 지정된 호출의 현재 상태 반환합니다.

구문

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

매개 변수

hCall

쿼리할 호출에 대한 핸들입니다. hCall의 호출 상태는 모든 상태일 수 있습니다.

lpCallStatus

LINECALLSTATUS 형식의 고정 크기 데이터 구조에 대한 포인터입니다. 요청이 성공적으로 완료되면 이 구조는 호출 상태 정보로 채워집니다. lineGetCallStatus를 호출하기 전에 애플리케이션은 정보를 반환하기 위해 TAPI에 사용할 수 있는 메모리 양을 나타내기 위해 이 구조체의 dwTotalSize 멤버를 설정해야 합니다.

참고 구조의 크기 매개 변수가 올바르지 않으면 데이터를 덮어쓸 수 있습니다. 구조체 크기를 설정하는 방법에 대한 자세한 내용은 메모리 할당 항목을 참조하세요.

반환 값

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

LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

설명

lineGetCallStatus 함수는 호출의 동적 상태 반환하는 반면 lineGetCallInfo는 주로 호출에 대한 정적 정보를 반환합니다. 호출 상태 정보에는 현재 호출 상태, 이 상태에 있는 동안 호출과 관련된 자세한 모드 정보(있는 경우) 및 호출이 이 상태에 있는 동안 애플리케이션이 호출에서 호출할 수 있는 사용 가능한 API 함수 목록이 포함됩니다. 애플리케이션은 일반적으로 LINE_CALLSTATE 메시지로 통화 상태 변경에 대한 알림을 받을 때 이 정보를 요청하는 데 관심이 있습니다.