lineGetNewCalls 함수(tapi.h)

아티클
08/26/2023

lineGetNewCalls 함수는 애플리케이션에 현재 핸들이 없는 지정된 줄 또는 주소의 호출에 대한 호출 핸들을 반환합니다. 애플리케이션에는 이러한 호출에 대한 모니터 권한이 부여됩니다.

구문

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

매개 변수

hLine

열린 줄 디바이스에 대한 핸들입니다.

dwAddressID

지정된 열린 줄 디바이스의 주소입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

dwSelect

요청된 호출의 선택입니다. 이 매개 변수는 LINECALLSELECT_ 상수 중 하나만 사용합니다.

lpCallList

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

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

반환 값

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

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

설명

애플리케이션은 lineGetNewCalls 를 사용하여 현재 핸들이 없는 호출에 대한 핸들을 가져올 수 있습니다. 애플리케이션은 이 선택 영역을 scope(지정된 줄에서 호출 또는 지정된 주소에 대한 호출)을 기반으로 하여 핸들이 반환될 호출을 선택할 수 있습니다. 예를 들어 애플리케이션은 현재 핸들이 없는 지정된 주소의 모든 호출에 대한 호출 핸들을 요청할 수 있습니다. 애플리케이션에는 항상 새 호출 핸들에 대한 모니터 권한이 부여됩니다. 또한 선을 열 때 애플리케이션은 이 함수를 사용하여 기존 호출을 인식합니다.

애플리케이션은 목록의 각 호출에 대해 lineGetCallInfo 및 lineGetCallStatus를 호출하여 호출 정보와 상태 각각 확인할 수 있습니다. lineSetCallPrivilege를 사용하여 해당 권한을 소유자로 변경할 수 있습니다.