lineCompleteCall 함수(tapi.h)

아티클
08/26/2023

lineCompleteCall 함수는 정상적으로 연결할 수 없는 호출을 대신 완료하는 방법을 지정합니다. 네트워크 리소스가 사용 중이거나 원격 스테이션이 사용 중이거나 응답하지 않으므로 네트워크 또는 스위치가 통화를 완료하지 못할 수 있습니다. 애플리케이션은 여러 가지 방법 중 하나로 호출을 완료하도록 요청할 수 있습니다.

구문

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

매개 변수

hCall

완료가 요청된 호출에 대한 핸들입니다. 애플리케이션은 호출의 소유자여야 합니다. hCall의 호출 상태는 사용 중이거나 링백이어야 합니다.

lpdwCompletionID

DWORD 크기의 메모리 위치에 대한 포인터입니다. 완료 식별자는 진행 중인 개별 완료 요청을 식별하는 데 사용됩니다. 완료 식별자가 유효하지 않으며 요청이 완료된 후 또는 미해결 요청이 취소된 후 다시 사용할 수 있습니다.

dwCompletionMode

호출을 완료하는 방법입니다. 이 매개 변수는 LINECALLCOMPLMODE_ 상수 중 하나만 사용합니다.

dwMessageID

LINECALLCOMPLMODE_MESSAGE 사용하여 통화를 완료할 때 보낼 메시지입니다. 이 식별자는 미리 정의된 소수의 메시지에서 메시지를 선택합니다.

반환 값

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

LINEERR_COMPLETIONOVERRUN, LINEERR_NOMEM, LINEERR_INVALCALLCOMPLMODE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMESSAGEID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED.

설명

이 함수는 네트워크 또는 스위치에서 요청을 수락한 경우 완료된 것으로 간주됩니다. 지정된 방식으로 요청이 완전히 완료된 경우는 아닙니다. 이 함수가 완료되면 호출은 일반적으로 유휴 상태로 전환됩니다. 호출된 스테이션 또는 네트워크가 요청된 대로 호출을 완료할 수 있는 상태로 들어가면 호출 상태가 제공과 동일한 LINE_CALLSTATE 메시지로 애플리케이션에 알림이 전송됩니다. 호출의 LINECALLINFO 레코드는 호출 이유를 CALLCOMPLETION으로 나열하고 완료 식별자도 제공합니다. 미해결 호출 완료 요청이 여러 대 있을 수 있습니다. 최대 수는 디바이스에 따라 다릅니다. 완료 식별자는 각 개별 요청을 참조하는 데도 사용되므로 lineUncompleteCall을 호출하여 요청을 취소할 수 있습니다.