LINELOCATIONENTRY 구조체(tapi.h)

  • 아티클

LINELOCATIONENTRY 구조는 주소 변환 컨텍스트를 제공하는 데 사용되는 위치를 설명합니다. LINETRANSLATECAPS 구조체에는 LINELOCATIONENTRY 구조체의 배열이 포함될 수 있습니다.

구문

typedef struct linelocationentry_tag {
  DWORD dwPermanentLocationID;
  DWORD dwLocationNameSize;
  DWORD dwLocationNameOffset;
  DWORD dwCountryCode;
  DWORD dwCityCodeSize;
  DWORD dwCityCodeOffset;
  DWORD dwPreferredCardID;
  DWORD dwLocalAccessCodeSize;
  DWORD dwLocalAccessCodeOffset;
  DWORD dwLongDistanceAccessCodeSize;
  DWORD dwLongDistanceAccessCodeOffset;
  DWORD dwTollPrefixListSize;
  DWORD dwTollPrefixListOffset;
  DWORD dwCountryID;
  DWORD dwOptions;
  DWORD dwCancelCallWaitingSize;
  DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;

멤버

dwPermanentLocationID

영구. 위치를 식별합니다.

dwLocationNameSize

null 종료 문자를 포함하여 null로 끝나는 위치 이름 문자열의 크기(문자)입니다.

dwLocationNameOffset

LINETRANSLATECAPS 구조체의 시작 부분부터 사용자에게 친숙한 방식으로 위치를 설명하는 null로 끝나는 문자열까지 dwLocationNameSize에 지정된 오프셋 크기입니다.

dwCountryCode

위치의 국가 또는 지역 코드입니다.

dwCityCodeSize

null 종료 문자를 포함하여 null로 끝나는 도시 코드 문자열의 크기(문자)입니다.

dwCityCodeOffset

이 구조체의 시작 부분에서 위치와 연결된 도시/지역 코드를 지정하는 null로 끝나는 문자열까지 dwCityCodeSize에 지정된 오프셋입니다. 국가 또는 지역 코드와 함께 이 정보는 응용 프로그램에서 전화 번호를 입력할 때 사용자의 "기본" 입력 필드로 사용하여 적절한 정식 번호의 입력을 장려할 수 있습니다.

dwPreferredCardID

이 위치에서 전화를 걸 때 기본 통화 카드.

dwLocalAccessCodeSize

null 종결자를 포함한 로컬 액세스 코드 문자열의 크기(바이트)입니다.

dwLocalAccessCodeOffset

LINETRANSLATECAPS 구조체의 시작부터 로컬 호출 영역의 주소를 호출하기 전에 전화를 걸 액세스 코드를 포함하는 null로 끝나는 문자열까지 dwLocalAccessCodeSize에 지정된 오프셋 크기입니다.

dwLongDistanceAccessCodeSize

null 종결자를 포함한 장거리 액세스 코드의 크기(바이트)입니다.

dwLongDistanceAccessCodeOffset

LINETRANSLATECAPS 구조체의 시작부터 로컬 호출 영역 외부의 주소로 호출하기 전에 전화를 걸 액세스 코드가 포함된 null로 끝나는 문자열까지 dwLongDistanceAccessCodeSize에 지정된 오프셋 크기입니다.

dwTollPrefixListSize

null 종결자를 포함한 통행료 접두사 크기(바이트)입니다.

dwTollPrefixListOffset

LINETRANSLATECAPS 구조체의 시작 부분에서 위치에 대한 통행료 접두사 목록을 포함하는 null로 끝나는 문자열까지 dwTollPrefixListSize에 지정된 오프셋 크기입니다. 문자열에는 숫자 "0"부터 "9"까지의 숫자로 구성된 접두사만 포함되며, 서로 단일 ","(쉼표) 문자로 구분됩니다.

dwCountryID

위치에 대해 선택한 국가/지역의 식별자입니다. lineGetCountry 함수와 함께 사용하여 국가/지역 이름과 같은 특정 국가/지역에 대한 추가 정보를 가져올 수 있습니다(국가/지역 코드가 고유하지 않으므로 dwCountryCode 멤버를 이 용도로 사용할 수 없음).

dwOptions

LINELOCATIONOPTION_ 상수에서 가져온 값을 사용하여 이 위치에 적용되는 옵션입니다.

dwCancelCallWaitingSize

cancel-call-waiting 문자열의 크기(바이트)입니다.

dwCancelCallWaitingOffset

LINETRANSLATECAPS 구조체의 시작부터 애플리케이션이 lineTranslateAddress의 dwTranslateOptions 매개 변수에서 LINETRANSLATEOPTION_CANCELCALLWAITING 비트를 설정할 때 다이얼 가능 문자열(펄스/톤 문자 뒤)에 접두사를 지정해야 하는 다이얼 숫자와 한정자를 포함하는 null로 끝나는 문자열까지 dwCancelCallWaitingSize에 지정된 오프셋 크기입니다. 접두사를 정의하지 않으면 dwCancelCallWaitingSize 를 0 또는 1로 설정할 수 있으며 dwCancelCallWaitingOffset 은 빈 문자열(단일 NULL 바이트)을 가리킬 수 있습니다.

설명

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

이전 애플리케이션은 이러한 새 필드를 모르고 새 크기보다 작은 SIZEOF LINELOCATIONENTRY를 사용하여 컴파일됩니다. LINETRANSLATECAPS 구조체의 변수 부분에 있는 배열이므로 이전 애플리케이션은 이전에 예상한 형식으로 LINELOCATIONENTRY 구조를 받거나 배열을 제대로 인덱싱할 수 없습니다. 애플리케이션은 lineGetTranslateCaps 함수를 사용하여 dwAPIVersion 매개 변수를 전달합니다. 이 함수는 이 상황을 처리하는 TAPI의 지침에 사용할 수 있습니다. lineGetTranslateCaps 함수는 애플리케이션에 반환할 LINETRANSLATECAPS 구조를 빌드할 때 표시된 API 버전과 일치하는 LINELOCATIONENTRY 멤버 및 크기를 사용해야 합니다.

요구 사항

요구 사항 값
헤더 tapi.h

추가 정보

LINETRANSLATECAPS

lineGetCountry

lineGetTranslateCaps

lineTranslateAddress