TSPI_lineUnpark 함수(tspi.h)

아티클
08/26/2023

TSPI_lineUnpark 함수는 지정된 주소에 대기된 호출을 검색하고 해당 호출 핸들을 반환합니다.

구문

LONG TSPIAPI TSPI_lineUnpark(
  DRV_REQUESTID dwRequestID,
  HDRVLINE      hdLine,
  DWORD         dwAddressID,
  HTAPICALL     htCall,
  LPHDRVCALL    lphdCall,
  LPCWSTR       lpszDestAddress
);

매개 변수

dwRequestID

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

hdLine

호출을 취소할 줄에 대한 핸들입니다.

dwAddressID

unpark를 시작하는 hdLine의 주소입니다. 주소 식별자는 주소와 영구적으로 연결됩니다. 식별자는 운영 체제 업그레이드에서 일정하게 유지됩니다. TAPI는 이 함수가 호출되면 이 매개 변수의 유효성을 검사하지 않습니다.

htCall

새 unparked 호출에 대한 TAPI 핸들입니다. 서비스 공급자는 이를 저장하고 호출 시 이벤트를 보고하는 LINEEVENT 프로시저에 대한 모든 후속 호출에서 사용해야 합니다.

lphdCall

새 바인딩되지 않은 호출에 대한 서비스 공급자의 식별자를 나타내는 HDRVCALL 에 대한 포인터입니다. 서비스 공급자는 이 프로시저가 반환되기 전에 호출에 대한 핸들로 이 위치를 채워야 합니다. 함수에서 오류가 발생하는 경우 이 핸들은 유효하지 않습니다.

lpszDestAddress

호출이 대기되는 주소를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 주소는 전화 걸기 가능한 주소 형식입니다.

반환 값

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

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

설명

이 함수는 호출 수명을 시작하기 위해 TSPI 모델을 따른다는 점에서 해당 TAPI 함수와 다릅니다. TAPI와 서비스 공급자는 서로 호출을 나타내는 불투명 핸들을 교환합니다. 또한 서비스 공급자는 이 절차에서 반환되기 전에 새 호출에 대한 콜백을 수행할 수 있습니다. 어떤 경우든 서비스 공급자는 일치하는 ASYNC_COMPLETION 메시지가 성공을 보고할 때까지 반환된 핸들을 "아직 유효하지 않음"으로 처리해야 합니다. 즉, 새 호출에 대한 LINEEVENT 메시지를 실행하거나 메시지의 호출 수 또는 줄에 대한 데이터 구조 상태 포함해서는 안 됩니다.

이 함수에서 만든 호출 핸들은 호출에 대한 원래 호출 핸들이 아직 존재하더라도( TSPI_lineCloseCall 의해 제거되지 않은) 새로운 고유한 호출 핸들입니다.