linePickup 함수(tapi.h)

아티클
03/05/2024

linePickup 함수는 지정된 대상 주소에서 호출 경고를 선택하고 선택한 호출에 대한 호출 핸들을 반환합니다. lpszDestAddress 매개 변수에 대해 NULL을 사용하여 호출하면 그룹 픽업이 수행됩니다. 디바이스에서 필요한 경우 lpszGroupID 는 경고 스테이션이 속한 그룹 식별자를 지정합니다.

구문

LONG linePickup(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCSTR  lpszDestAddress,
  LPCSTR  lpszGroupID
);

매개 변수

hLine

호출을 선택할 열린 회선 디바이스에 대한 핸들입니다.

dwAddressID

픽업이 시작되는 hLine 의 주소입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다.

lphCall

선택한 호출에 대한 핸들이 반환되는 메모리 위치에 대한 포인터입니다. 애플리케이션은 호출의 초기 단독 소유자입니다.

lpszDestAddress

호출을 선택할 주소가 포함된 null로 끝나는 문자 버퍼에 대한 포인터입니다. 주소는 표준 전화 걸기 가능 주소 형식입니다.

lpszGroupID

경고 스테이션이 속한 그룹 식별자를 포함하는 null로 끝나는 문자 버퍼에 대한 포인터입니다. 이 매개 변수는 현재 픽업 그룹 외부에서 호출을 받기 위해 일부 스위치에 필요합니다.

lpszGroupID 매개 변수는 lpszDestAddress에 대한 NULL 포인터를 사용하여 단독으로 지정할 수 있습니다. 또는 디바이스에서 필요한 경우 lpszDestAddress 외에도 lpszGroupID를 지정할 수 있습니다.

반환 값

함수가 비동기적으로 완료된 경우 양수 요청 식별자를 반환하거나 오류가 발생할 경우 음수 오류 번호를 반환합니다. 함수가 성공하면 해당 LINE_REPLY 메시지의 dwParam2 매개 변수가 0이거나 오류가 발생하면 음수 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INVALADDRESS, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALGROUPID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED.

설명

호출이 성공적으로 선택되면 호출 상태 변경에 대한 LINE_CALLSTATE 메시지로 애플리케이션에 알림이 표시됩니다. LINECALLINFO 구조체는 선택한 호출에 대한 정보를 제공합니다. 호출 이유를 픽업으로 나열합니다. 이 구조체는 lineGetCallInfo를 사용하여 사용할 수 있습니다.

LINEADDRCAPFLAGS_PICKUPCALLWAIT TRUE인 경우 linePickup 을 사용하여 사용자가 통화 대기 신호를 청각적으로 검색했지만 공급자가 검색을 수행할 수 없는 호출을 선택할 수 있습니다. 이렇게 하면 서비스 공급자가 통화 대기 신호를 감지할 수 없더라도 대기 중인 호출에 "응답"하는 메커니즘이 사용자에게 제공됩니다. 호출 대기 호출을 선택하려면 lpszDestAddress 및 lpszGroupID 포인터 매개 변수가 모두 NULL 이어야 합니다. linePickup 함수는 대기 중인 호출에 대한 새 호출 핸들을 만들고 해당 핸들을 사용자에게 전달합니다. dwAddressID 매개 변수는 가장 자주 0입니다(특히 한 줄 주거의 경우).

linePickup을 사용하여 두 번째 호출을 선택한 후 lineSwapHold를 사용하여 둘 사이를 전환할 수 있습니다. lineDrop 함수를 사용하여 하나를 삭제하고 다른 함수로 전환할 수 있습니다. 사용자가 현재 호출을 삭제하고 두 번째 호출을 선택하려는 경우 통화 대기 경고음이 발생할 때 lineDrop 을 호출하고, 두 번째 호출이 울리기를 기다린 다음, 새 호출 핸들에서 lineAnswer 를 호출해야 합니다. LINEADDRESSSTATUS의 dwAddressFeatures 멤버에 있는 LINEADDRFEATURE_PICKUP 플래그는 픽업이 실제로 가능한 시기를 나타냅니다.