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

HandoffDirect 메서드는 다른 애플리케이션에 대한 호출을 전달합니다. 이는 애플리케이션에 더 이상 호출 소유권이 필요하지 않음을 나타냅니다.

구문

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

[in] pApplicationName

호출을 전달할 특정 애플리케이션 이름을 포함하는 BSTR 에 대한 포인터입니다. 전체 경로 이름 또는 실행 파일 이름일 수 있습니다.

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

반환 코드	Description
S_OK	메서드가 정상적으로 실행되었습니다.
E_OUTOFMEMORY	메모리가 부족하여 작업을 수행할 수 없습니다.
E_POINTER	pApplicationName 매개 변수가 유효한 포인터가 아닙니다.

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

수신 애플리케이션이 통화와 관련된 미디어 유형에 대한 줄을 열지 않은 경우 핸드오프가 실패합니다. TAPI가 통화를 전달하지 못하면 TAPI는 Disconnect를 호출 합니다.

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