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

  • 아티클

TranslateDialog 메서드는 사용자가 전화를 걸 전화 번호의 현재 위치를 변경하고, 위치를 조정하고, 카드 매개 변수를 호출하고, 효과를 볼 수 있는 애플리케이션 모달 대화 상자를 표시합니다.

구문

HRESULT TranslateDialog(
  [in] TAPIHWND hwndOwner,
  [in] BSTR     pAddressIn
);

매개 변수

[in] hwndOwner

대화 상자를 연결할 창에 대한 핸들입니다. 함수 중에 만든 창에 소유자 창이 없어야 함을 나타내는 NULL 값일 수 있습니다.

[in] pAddressIn

사용자의 변경 내용이 위치 매개 변수에 미치는 영향을 표시하는 데 사용되는 전화 번호가 포함된 BSTR 에 대한 포인터입니다. 숫자는 정식 형식이어야 합니다. 이 포인터는 NULL로 남겨둘 수 있습니다. 이 경우 대화 상자의 전화 번호 부분이 표시되지 않습니다. pAddressIn 매개 변수에 하위 주소 또는 이름 필드 또는 ASCII CR 및 LF 문자로 첫 번째 주소와 구분된 추가 주소가 포함된 경우 대화 상자에서 첫 번째 주소만 사용됩니다.

반환 값

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

반환 코드 Description
S_OK
 메서드가 정상적으로 실행되었습니다.
E_INVALIDARG
 hwndOwner 매개 변수가 유효한 핸들이 아니거나 pAddressIn 매개 변수가 유효한 전화 번호가 아닙니다.
E_POINTER
 pAddressIn 매개 변수가 유효한 포인터가 아닙니다.
E_OUTOFMEMORY
 메모리가 부족하여 작업을 수행할 수 없습니다.
E_UNEXPECTED
 예기치 않은 오류가 발생했습니다.
TAPI_E_REGISTRY_SETTING_CORRUPT
 주소 변환에 대한 레지스트리 설정이 잘못되었습니다.
TAPI_E_NODRIVER
 이 주소에 대한 번역을 수행할 수 있는 TSP가 없습니다.
TAPI_E_INUSE
 대화 상자가 이미 열려 있고 사용 중입니다.
TAPI_E_INVALADDRESS
 현재 주소가 잘못되었습니다.
TAPI_E_OPERATIONFAILED
 TAPI에서 작업을 완료할 수 없습니다.

설명

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

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

요구 사항

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

추가 정보

Address 개체

ITAddressTranslation

LineTranslateDialog