다음을 통해 공유

tapiRequestMakeCall 함수(tapi.h)

  • 아티클

tapiRequestMakeCall 함수는 음성 통화의 설정을 요청합니다. 호출 관리자 애플리케이션은 요청 애플리케이션을 대신하여 호출을 설정한 다음, 사용자의 call-manager 애플리케이션에 의해 제어됩니다.

구문

LONG tapiRequestMakeCall(
  LPCSTR lpszDestAddress,
  LPCSTR lpszAppName,
  LPCSTR lpszCalledParty,
  LPCSTR lpszComment
);

매개 변수

lpszDestAddress

호출 요청의 null 종료 대상 주소가 있는 메모리 위치에 대한 포인터입니다. 주소는 정식 주소 형식을 사용할 수 있습니다. 이 작업에서는 지정된 주소의 유효성을 검사하지 않습니다. 주소의 최대 길이는 NULL 종결자를 포함하는 TAPIMAXDESTADDRESSSIZE 문자입니다.

lpszAppName

호출 요청의 null 종료 사용자 친화적인 애플리케이션 이름이 있는 메모리 위치에 대한 포인터입니다. 애플리케이션이 애플리케이션 이름을 제공하지 않는 경우 이 포인터는 NULL 로 남을 수 있습니다. 주소의 최대 길이는 NULL 종결자를 포함하는 TAPIMAXAPPNAMESIZE 문자입니다. 이보다 긴 문자열은 잘립니다.

lpszCalledParty

호출의 호출된 파티에 대해 null로 종료된 파티 이름이 있는 메모리 위치에 대한 포인터입니다. 애플리케이션에서 이 정보를 제공하지 않으려면 이 포인터를 NULL 로 남겨 둘 수 있습니다. 문자열의 최대 길이는 NULL 종결자를 포함하는 TAPIMAXCALLEDPARTYSIZE 문자입니다. 이보다 긴 문자열은 잘립니다.

lpszComment

호출에 대한 null로 종료된 주석이 있는 메모리 위치에 대한 포인터입니다. 애플리케이션에서 주석을 제공하지 않는 경우 이 포인터는 NULL 로 남을 수 있습니다. 주소의 최대 길이는 NULL 종결자를 포함하는 TAPIMAXCOMMENTSIZE 문자입니다. 이보다 긴 문자열은 잘립니다.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 오류 반환 값은 다음과 같습니다.

TAPIERR_NOREQUESTRECIPIENT, TAPIERR_INVALDESTADDRESS, TAPIERR_REQUESTQUEUEFULL, TAPIERR_INVALPOINTER.

설명

전화 통신 사용 애플리케이션은 tapiRequestMakeCall을 호출하여 호출에 대한 대상 주소만 제공하여 호출을 대신하도록 요청할 수 있습니다. 이 요청은 원래 애플리케이션을 대신하여 호출을 배치하는 사용자의 호출 제어 애플리케이션으로 전달됩니다. 기본 호출 제어 애플리케이션은 전화 통신의 일부로 제공됩니다. 사용자는 이를 원하는 호출 제어 애플리케이션으로 바꿀 수 있습니다.

호출 제어 애플리케이션이 실행되고 있지 않을 때 tapiRequestMakeCall 을 호출하면 TAPIERR_NOREQUESTRECIPIENT 오류 표시가 반환됩니다. 호출 제어 애플리케이션이 실행되고 있지 않으면 TAPI는 가장 우선 순위가 높은 호출 제어 애플리케이션(레지스트리의 RequestMakeCall 에 대해 나열됨)을 시작하려고 시도합니다. 보조 TAPI 요청 큐가 가득 차면 이 함수를 호출하면 TAPIERR_REQUESTQUEUEFULL 오류가 반환됩니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 tapi.h
라이브러리 Tapi32.lib
DLL Tapi32.dll

추가 정보

보조 전화 통신 서비스 참조

TAPI 2.2 참조 개요