다음을 통해 공유


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

Forward 메서드는 ITForwardInformation에 포함된 전달 지침에 따라 주소로 향하는 호출을 전달합니다. pForwardInfoNULL로 설정된 경우 전달이 취소됩니다.

구문

HRESULT Forward(
  [in] ITForwardInformation *pForwardInfo,
  [in] ITBasicCallControl   *pCall
);

매개 변수

[in] pForwardInfo

ITForwardInformation 인터페이스에 대한 포인터이거나 전달을 취소하려면 NULL로 설정합니다.

[in] pCall

전화 통신 환경에서 필요한 경우 상담 통화에 대한 ITBasicCallControl 인터페이스에 대한 포인터입니다. 필요하지 않은 경우 NULL 일 수 있습니다.

반환 값

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

반환 코드 Description
S_OK
메서드가 정상적으로 실행되었습니다.
E_INVALIDARG
주소는 전달을 지원하지 않거나 pCall이 유효한 호출을 가리키지 않습니다.
E_OUTOFMEMORY
메모리가 부족하여 작업을 수행할 수 없습니다.
E_POINTER
pForwardInfo 또는 pCall 매개 변수가 유효한 포인터가 아닙니다.
TAPI_E_TIMEOUT
TAPI 3 DLL의 시간이 초과되어 작업이 실패했습니다. 시간 제한 간격은 2분입니다.
LINEERR_
이 TAPI 2.1 함수에서 반환된 오류 코드는 LineForward 를 참조하세요.

설명

pForwardInfo의 정보는 이전 전달 지침을 재정의합니다.

fDoNotDisturbVARIANT_FALSE 설정된 상태에서 ITAddress::p ut_DoNotDisturb가 호출되면 모든 전달이 취소됩니다.

애플리케이션은 ITAddressCapabilities::get_AddressCapability(AC_ADDRESSCAPFLAGS, plCapability)를 호출하고 LINEADDRCAPFLAGS_ 상수의 멤버인 플래그 LINEADDRCAPFLAGS_FWDCONSULT plCapability로 설정되었는지 여부를 확인하여 NULL이 아닌 상담 호출이 필요한지 여부를 확인할 수 있습니다. 설정된 경우 Forward 메서드의 pCall 매개 변수에 NULL이 아닌 값이 필요합니다.

Forward 메서드는 부분적으로 TAPI 2.1 LineForward 함수에 대한 COM 래퍼입니다.

요구 사항

   
대상 플랫폼 Windows
헤더 tapi3if.h(Tapi3.h 포함)
라이브러리 Uuid.lib
DLL Tapi3.dll

추가 정보

Address 개체

전달 개요

ITAddress

ITAddress::CreateForwardInfoObject

ITAddress::get_CurrentForwardInfo

ITForwardInformation

LineForward