LINETRANSLATEOUTPUT 구조체(tapi.h)

  • 아티클

LINETRANSLATEOUTPUT 구조체는 주소 변환의 결과를 설명합니다. lineTranslateAddress 함수는 이 구조를 사용합니다.

구문

typedef struct linetranslateoutput_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwDialableStringSize;
  DWORD dwDialableStringOffset;
  DWORD dwDisplayableStringSize;
  DWORD dwDisplayableStringOffset;
  DWORD dwCurrentCountry;
  DWORD dwDestCountry;
  DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;

멤버

dwTotalSize

이 데이터 구조에 할당된 총 크기(바이트)입니다.

dwNeededSize

반환된 모든 정보를 바이트 단위로 보관하려면 이 데이터 구조에 필요한 크기입니다.

dwUsedSize

유용한 정보를 포함하는 이 데이터 구조의 부분 크기(바이트)입니다.

dwDialableStringSize

종료 NULL을 포함하여 전화 걸기 가능한 문자열 크기(바이트)입니다.

dwDialableStringOffset

이 구조체의 시작 부분에서 lineMakeCall, lineDial 또는 전화 걸기 문자열이 필요한 기타 함수에 전달할 수 있는 변환된 출력으로 오프셋됩니다. 출력은 항상 null로 끝나는 문자열입니다. 이름 및 하위 주소와 같은 보조 필드는 입력 문자열에 있는 경우 이 출력 문자열에 포함됩니다. 이 문자열에는 카드 번호 호출과 같은 개인 정보가 포함될 수 있습니다. 권한이 없는 사람이 실수로 표시되지 않도록 사용자에게 표시해서는 안 됩니다. 필드의 크기는 dwDialableStringSize로 지정됩니다.

dwDisplayableStringSize

null 종결자를 포함하여 사용자에게 표시할 수 있는 변환된 출력의 크기(바이트)입니다.

dwDisplayableStringOffset

확인을 위해 사용자에게 표시할 수 있는 변환된 출력에 대한 오프셋입니다. 호출 카드 숫자가 대괄호 문자로 묶인 카드 이름(예: "[AT&T 카드]")으로 대체되고 이름 및 하위 주소와 같은 보조 필드가 제거된다는 점을 제외하고 DialableString과 동일합니다. 문자열이 호출 상태 대화 상자에 공개적으로 표시될 수 있으므로 dwDisplayableStringOffset에서 적절한 메시지를 사용합니다. 이 정보는 통화 로그에 포함하기에도 적합합니다. 필드의 크기는 dwDisplayableStringSize로 지정됩니다.

dwCurrentCountry

CurrentLocation에 구성된 국가 또는 지역 코드입니다. 이 값은 특정 사용자 인터페이스 요소의 애플리케이션, 로컬 호출 진행률 톤 검색 및 기타 용도로 표시를 제어하는 데 사용할 수 있습니다.

dwDestCountry

번역된 주소의 대상 국가/지역 코드입니다. 이 값은 lineMakeCall 및 기타 전화 걸기 함수의 dwCountryCode 매개 변수에 전달될 수 있습니다(사용 중인 신호와 같은 대상 국가/지역의 호출 진행률 톤이 제대로 검색되도록). lineTranslateAddress에 전달된 대상 주소가 정식 형식이 아닌 경우 이 필드는 0으로 설정됩니다.

dwTranslateResults

애플리케이션이 사용자 인터페이스 요소를 표시하는 데 도움이 될 수 있는 번역 프로세스에서 파생된 정보입니다. 이 필드는 LINETRANSLATERESULT_ 상수 중 하나를 사용합니다.

설명

이 구조체는 확장할 수 없습니다.

요구 사항

요구 사항 값
헤더 tapi.h

추가 정보

lineDial

lineMakeCall

lineTranslateAddress