TSPI_lineCompleteCall 함수(tspi.h)

아티클
03/03/2024

TSPI_lineCompleteCall 함수는 정상적으로 연결할 수 없는 호출을 대신 완료하는 방법을 지정하는 데 사용됩니다. 네트워크 리소스가 사용 중이거나 원격 스테이션이 사용 중이거나 응답하지 않으므로 네트워크 또는 스위치가 통화를 완료하지 못할 수 있습니다.

구문

LONG TSPIAPI TSPI_lineCompleteCall(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPDWORD       lpdwCompletionID,
  DWORD         dwCompletionMode,
  DWORD         dwMessageID
);

매개 변수

dwRequestID

비동기 요청의 식별자입니다.

hdCall

완료가 요청된 호출에 대한 서비스 공급자의 핸들입니다. hdCall의 호출 상태는 사용 중, 링백 또는 계속 중일 수 있습니다.

lpdwCompletionID

서비스 공급자가 완료 식별자를 작성하는 DWORD 크기의 메모리 위치에 대한 포인터입니다. 이는 hdCall이 포함된 줄에서 진행 중인 완료 요청을 고유하게 식별합니다. 특히 요청이 완료되면 완료 식별자가 유효하지 않거나 TSPI_lineUncompleteCall 함수를 사용하여 취소됩니다. 서비스 공급자는 무효화되는 즉시 완료 식별자를 자유롭게 다시 사용할 수 있습니다.

dwCompletionMode

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

dwMessageID

LINECALLCOMPLMODE_MESSAGE 사용하여 통화를 완료할 때 보낼 메시지입니다. 이 식별자는 미리 정의된 소수의 메시지에서 메시지를 선택합니다. 이 함수가 호출될 때 TAPI에서 이 매개 변수의 유효성을 검사하지 않습니다.

반환 값

오류가 발생하면 dwRequestID 또는 오류 번호를 반환합니다. 해당 ASYNC_COMPLETIONlResult 실제 매개 변수는 함수가 성공하면 0이거나 오류가 발생하면 오류 번호입니다. 가능한 반환 값은 다음과 같습니다.

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

설명

이 함수는 네트워크 또는 스위치에서 요청을 수락할 때 완료된 것으로 간주됩니다. 지정된 방식으로 요청이 완전히 완료된 경우는 아닙니다. 호출된 스테이션 또는 네트워크가 요청된 대로 호출을 완료할 수 있는 상태가 되면 서비스 공급자는 호출 상태가 제공과 동일한 LINE_CALLSTATE 메시지를 보내야 합니다. 호출의 LINECALLINFO 레코드는 호출 이유를 CALLCOMPLETION으로 나열하고 완료 식별자도 제공합니다. 지정된 시간에 여러 호출 완료 요청이 처리될 수 있습니다. 최대 수는 디바이스에 따라 다릅니다. 완료 식별자는 각 개별 요청을 참조하는 데도 사용되므로 TSPI_lineUncompleteCall 호출하여 요청을 취소할 수 있습니다.