lineGetCallInfo 함수(tapi.h)

아티클
08/26/2023

lineGetCallInfo 함수를 사용하면 애플리케이션이 지정된 호출에 대한 고정 정보를 가져올 수 있습니다.

구문

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

매개 변수

hCall

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

lpCallInfo

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

반환 값

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

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

설명

들어오거나 나가는 모든 호출에 대해 별도의 LINECALLINFO 구조가 있습니다. 구조체에는 주로 호출에 대한 고정 정보가 포함됩니다. 애플리케이션은 일반적으로 LINE_CALLSTATE 메시지의 호출에 대한 핸들을 수신하거나 통화 정보 구조의 일부가 변경되었다는 LINE_CALLINFO 메시지의 알림을 받을 때마다 이 정보를 확인하는 데 관심이 있습니다. 이러한 메시지는 호출에 대한 핸들을 매개 변수로 공급합니다.