ITAddress::CreateCall 메서드(tapi3if.h)

아티클
03/02/2024

CreateCall 메서드는 나가는 호출을 만드는 데 사용할 수 있는 새 Call 개체를 만들고 개체의 ITBasicCallControl 인터페이스에 대한 포인터를 반환합니다. 새로 만든 호출은 CS_IDLE 상태 이며 미디어 또는 터미널이 선택되지 않았습니다.

호출 주소, 주소 유형 및 미디어 유형에 허용되는 입력 값은 현재 주소를 지원하는 전화 통신 서비스 공급자와 관련이 있습니다. Windows 2000과 함께 제공되는 TSP에 대한 자세한 내용은 TSP(전화 통신 서비스 공급자) 정보를 참조하세요. 타사 TSP의 경우 vender에서 제공하는 설명서를 참조하세요.

구문

HRESULT CreateCall(
  [in]  BSTR               pDestAddress,
  [in]  long               lAddressType,
  [in]  long               lMediaTypes,
  [out] ITBasicCallControl **ppCall
);

매개 변수

[in] pDestAddress

이 BSTR 문자열에는 대상 주소가 포함되어 있습니다. 형식은 공급자별로 다릅니다. 이 포인터는 전화를 걸지 않은 주소(예: 핫 전화)의 경우 또는 ITBasicCallControl::D ial을 사용하여 모든 전화 걸기를 수행할 때 NULL일 수 있습니다. ITBasicCallControl::P ickup의 NULLpGroupID와 함께 NULL을 사용하면 그룹 픽업이 발생합니다. 역 멀티플렉싱 기능이 있는 서비스 공급자는 애플리케이션에서 한 번에 여러 주소를 지정할 수 있습니다.

[in] lAddressType

주소 형식을 설명하는 LINEADDRESSTYPE_PHONENUMBER 같은 주소 유형 상수를 포함합니다. 값은 이 주소에 유효해야 합니다. AddressCap이 AC_ADDRESSTYPES 설정된 상태에서 ITAddressCapabilities::get_AddressCapability 사용하여 값을 확인합니다.

[in] lMediaTypes

호출 세션에 참여할 미디어 유형 또는 형식을 식별합니다.

[out] ppCall

ITBasicCallControl 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	의미
S_OK	메서드가 정상적으로 실행되었습니다.
E_INVALIDARG	주소 유형 lAddressType이 잘못되었거나 둘 이상의 주소 유형을 지정합니다.
E_OUTOFMEMORY	작업을 수행하기 위한 메모리가 부족합니다.
E_POINTER	ppCall 매개 변수가 유효한 포인터가 아닙니다.

설명

애플리케이션은 SysAllocString을 사용하여 pDestAddress 매개 변수에 대한 메모리를 할당하고 SysFreeString을 사용하여 변수가 더 이상 필요하지 않을 때 메모리를 해제해야 합니다.

주소 유형이 LINEADDRESSTYPE_SDP 경우 애플리케이션은 pDestAddress에서 ITSDP::get_IsValid 메서드를 호출하여 포함된 SDP 정보가 RFC 2327에 따라 제대로 생성되었는지 확인해야 합니다.

회의 중, 이전 또는 전달 작업 중과 같은 상담 통화로 사용되는 통화는 이 방법을 사용하여 만들어야 합니다.

TAPI는 ITAddress::CreateCall에서 반환된 ITBasicCallControl 인터페이스에서 AddRef 메서드를 호출합니다. 애플리케이션은 ITBasicCallControl 인터페이스에서 Release를 호출하여 연결된 리소스를 해제해야 합니다.

참고 이 메서드는 TAPI 2의 lineMakeCall 과 정확히 동일하지 않습니다. TAPI는 거의 동일한 정보를 제공하지만 ITBasicCallControl::Connect 가 호출될 때까지 병렬 작업이 수행되지 않습니다.