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

아티클
08/26/2023

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

구문

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의 정보는 이전 전달 지침을 재정의합니다.

fDoNotDisturb이 VARIANT_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 래퍼입니다.