lineGetCountry 함수(tapi.h)

아티클
03/02/2024

lineGetCountry 함수는 저장된 전화 걸기 규칙 및 지정된 국가/지역, 국가/지역 목록의 첫 번째 국가/지역 또는 모든 국가/지역과 관련된 기타 정보를 가져옵니다.

구문

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

매개 변수

dwCountryID

정보를 가져올 국가/지역의 국가/지역 식별자(국가 코드 아님)입니다. 값 1을 지정하면 국가/지역 목록의 첫 번째 국가/지역에 대한 정보를 가져옵니다. 값 0을 지정하면 모든 국가/지역에 대한 정보를 얻습니다(많은 메모리가 필요할 수 있습니다( 20KB 이상).

dwAPIVersion

애플리케이션에서 지원하는 가장 높은 버전의 TAPI(특정 라인 디바이스에서 lineNegotiateAPIVersion 으로 협상된 값이 반드시 있는 것은 아님).

lpLineCountryList

LINECOUNTRYLIST 구조가 로드되는 위치에 대한 포인터입니다. lineGetCountry를 호출하기 전에 애플리케이션은 정보를 반환하기 위해 TAPI에 사용할 수 있는 메모리 양을 나타내기 위해 이 구조체의 dwTotalSize 멤버를 설정해야 합니다.

참고 구조의 크기 매개 변수가 올바르지 않으면 데이터를 덮어쓸 수 있습니다. 구조체 크기를 설정하는 방법에 대한 자세한 내용은 메모리 할당 항목을 참조하세요.

반환 값

요청이 성공하면 0을 반환하고 오류가 발생하면 음수 오류 번호를 반환합니다. 가능한 반환 값은 다음과 같습니다.

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER.