TSPI_linePark 함수(tspi.h)

아티클
08/26/2023

TSPI_linePark 함수는 지정된 대기 모드에 따라 지정된 호출을 주차합니다.

구문

LONG TSPIAPI TSPI_linePark(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  DWORD         dwParkMode,
  LPCWSTR       lpszDirAddress,
  LPVARSTRING   lpNonDirAddress
);

매개 변수

dwRequestID

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

hdCall

대기할 호출에 대한 핸들입니다. hdCall의 호출 상태를 연결할 수 있습니다.

dwParkMode

호출을 대기할 공원 모드로, LINEPARKMODE_ 상수 중 하나만 대기합니다.

lpszDirAddress

directed park를 사용할 때 호출을 대기할 주소를 나타내는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 주소는 전화 걸기 가능한 주소 형식입니다. 이 매개 변수는 전달되지 않은 공원에 대해 무시됩니다.

lpNonDirAddress

VARSTRING 형식의 구조체에 대한 포인터입니다. 전달되지 않은 파크의 경우 호출이 대기되는 주소가 이 구조체에 반환됩니다. 이 매개 변수는 directed park에 대해 무시됩니다. VARSTRING 구조 내에서 dwStringFormat은 STRINGFORMAT_ASCII(null로 종료된 문자열을 포함하는 ASCII 문자열 버퍼)로 설정되어야 하며 종료 NULL은 dwStringSize에서 고려됩니다. lpNonDirAddress 매개 변수가 가리키는 메모리가 요청된 주소에 대해 충분히 크지 않으면 TSPI_linePark 함수는 LINEERR_STRUCTURETOOSMALL 반환합니다.

반환 값

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

LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALPARKMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL.

설명

dwTotalSize를 제외한 VARSTRING 구조체의 모든 멤버는 서비스 공급자에 의해 채워집니다. dwTotalSize 멤버는 TAPI에 의해 채워지고 서비스 공급자는 이 값을 덮어쓰지 않아야 합니다.

DIRECTED Park에서 클라이언트 애플리케이션(TAPI를 통해)은 호출을 대기하려는 주소를 지정합니다. 전달되지 않은 공원에서 스위치는 주소를 결정하고 이를 TAPI에 제공합니다. 두 경우 모두 이 주소를 지정하여 대기된 호출을 취소할 수 있습니다.

대기된 호출은 일반적으로 성공적으로 주차된 후 유휴 호출 상태가 됩니다. 서비스 공급자는 LINE_CALLSTATE 메시지를 사용하여 새 상태를 보고합니다. 후속 TSPI_lineUnpark TSPI_lineCloseCall 이전 핸들을 제거 했는지 여부에 관계없이 새로운 고유한 호출 핸들을 만듭니다.

일부 스위치는 오랜 시간 동안 통화가 대기된 후 사용자에게 알림을 표시할 수 있습니다. 서비스 공급자는 호출 이유가 미리 알림으로 설정된 제품 호출로 TAPI에 보고합니다(알려진 경우).