ITBasicCallControl::Transfer 메서드(tapi3if.h)

아티클
03/02/2024

Transfer 메서드는 현재 호출을 대상 주소로 전송합니다.

구문

HRESULT Transfer(
  [in] ITBasicCallControl *pCall,
  [in] VARIANT_BOOL       fSync
);

매개 변수

[in] pCall

전송을 위해 생성된 상담 호출의 ITBasicCallControl 인터페이스에 대한 포인터입니다.

[in] fSync

메서드를 동기(VARIANT_TRUE) 또는 비동기(VARIANT_FALSE)로 완료해야 하는지 여부를 나타냅니다.

반환 값

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

값	의미
S_OK	메서드가 정상적으로 실행되었습니다.
E_INVALIDARG	pCall 매개 변수는 유효한 호출을 가리키지 않습니다.
E_FAIL	전송은 지원되지 않습니다.
E_OUTOFMEMORY	작업을 수행하기 위한 메모리가 부족합니다.
TAPI_E_TIMEOUT	TAPI 3 DLL의 시간이 초과되어 작업이 실패했습니다. 시간 제한 간격은 2분입니다.

설명

스트리밍이 활성화된 동안 일부 서비스 공급자는 이 작업을 지원하지 않습니다. 애플리케이션은 작업 전에 ITStream::StopStream 또는 ITSubStream::StopSubStream 을 호출해야 할 수 있으며, 작업이 완료된 후 ITStream::StartStream 또는 ITSubStream::StartSubStream 을 호출해야 할 수 있습니다.

통화 이전에는 이전을 준비하기 위해 상담 전화를 설정하는 것이 포함됩니다. pCall은 상담 통화를 만든 후 ITAddress::CreateCall에서 반환한 ITBasicCallControl 포인터입니다. ITBasicCallControl::Finish (FM_ASTRANSFER)는 전송을 완료합니다.

Transfer가 호출될 때 상담 통화가 CONNECTED 상태가 아닌 경우 TAPI는 대상 주소(ITAddress::CreateCall을 통해 상담 전화를 처음 만들 때 지정한 대로)를 사용하고 해당 시간에 연결을 시도합니다. 원래 호출에 NULL 대상 주소가 있는 경우 E_INVALIDARG 전송 이 실패합니다.