다음을 통해 공유

ITAddressTranslation::TranslateAddress 메서드(tapi3if.h)

  • 아티클

TranslateAddress 메서드는 주소 변환 정보 인터페이스를 만듭니다. TranslateAddress 메서드의 주요 목표는 ITAddress::CreateCall에 대한 매개 변수로 필요한 pDestAddress 문자열(전화 걸기 가능 주소)을 가져오는 것입니다. TranslateAddress 메서드는 ITAddressTranslationInfo 개체의 속성 중 하나로 다이얼 가능한 주소를 간접적으로 반환합니다.

구문

HRESULT TranslateAddress(
  [in]  BSTR                     pAddressToTranslate,
  [in]  long                     lCard,
  [in]  long                     lTranslateOptions,
  [out] ITAddressTranslationInfo **ppTranslated
);

매개 변수

[in] pAddressToTranslate

번역이 필요한 주소를 포함하는 BSTR 에 대한 포인터입니다.

[in] lCard

번역에 사용되는 호출 카드.

[in] lTranslateOptions

번역 옵션 표시기에서 LINETRANSLATEOPTION__Constants 참조하세요.

[out] ppTranslated

새로 만든 ITAddressTranslationInfo 인터페이스에 대한 포인터입니다.

반환 값

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

값 의미
S_OK
 메서드가 정상적으로 실행되었습니다.
E_POINTER
 ppTranslated 매개 변수가 유효한 포인터가 아닙니다.
E_OUTOFMEMORY
 작업을 수행하기 위한 메모리가 부족합니다.
E_UNEXPECTED
 알 수 없는 이유로 메서드가 실패했습니다.
E_INVALIDARG
 lTranslateOptions 값이 잘못되었습니다.
TAPI_E_NODRIVER
 이 주소에는 연결된 TSP가 없습니다.
TAPI_E_REGISTRY_SETTING_CORRUPT
 레지스트리가 손상되었습니다.
TAPI_E_OPERATIONFAILED
 TAPI에서 메서드가 실패했습니다.
TAPI_E_RESOURCEUNAVAIL
 TSP를 사용할 수 없습니다.
TAPI_E_INVALCARD
 카드 번호가 잘못되었습니다.

설명

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

TranslateAddress 메서드는 TAPI 2.1 LineTranslateAddress 함수에 대한 COM 래퍼입니다.

TAPI는 TranslateAddress에서 반환된 ITAddressTranslationInfo 인터페이스에서 AddRef 메서드를 호출합니다. 애플리케이션은 ITAddressTranslationInfo 인터페이스에서 Release를 호출하여 연결된 리소스를 해제해야 합니다.

요구 사항

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

추가 정보

Address 개체

전화 걸기 가능 주소

ITAddressTranslation