ITBasicCallControl::D ial 메서드(tapi3if.h)

Dial 메서드는 지정된 주소를 다이얼합니다.

구문

HRESULT Dial(
  [in] BSTR pDestAddress
);

매개 변수

[in] pDestAddress

전화를 걸 주소의 BSTR 표현에 대한 포인터입니다. 형식은 표준 전화 걸기 주소를 준수해야 합니다.

반환 값

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

의미
S_OK
메서드가 정상적으로 실행되었습니다.
E_OUTOFMEMORY
작업을 수행하기 위한 메모리가 부족합니다.
E_POINTER
pDestAddress 매개 변수가 유효한 포인터가 아닙니다.
TAPI_E_TIMEOUT
TAPI 3 DLL의 시간이 초과되어 작업이 실패했습니다. 시간 제한 간격은 2분입니다.

설명

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

경우에 따라 애플리케이션은 주소 변환 인터페이스( ITAddressTranslationITAddressTranslationInfo)를 사용하여 적절한 형식의 pDestAddress 문자열을 가져와야 할 수 있습니다.

Dial 메서드는 호출이 이미 있다는 점에서 ITAddress::CreateCall과 다릅니다. 예를 들어 확장에 전화를 걸 수 있습니다.

요구 사항

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

추가 정보

호출 개체

다이얼 개요

전화 걸기 가능 주소

ITAddress::CreateCall

ITAddressTranslation

ITAddressTranslationInfo

ITBasicCallControl

lineDial