RasGetCountryInfoA 함수(ras.h)

  • 아티클

RasGetCountryInfo 함수는 국가/지역의 Windows 전화 통신 목록에서 국가/지역별 전화 걸기 정보를 검색합니다.

국가/지역별 전화 걸기 정보 및 TAPI(전화 통신 애플리케이션 프로그래밍 인터페이스) 국가/지역 식별자에 대한 자세한 내용은 SDK(플랫폼 소프트웨어 개발 키트)의 TAPI 부분을 참조하세요.

구문

DWORD RasGetCountryInfoA(
  [in, out] LPRASCTRYINFOA unnamedParam1,
  [in, out] LPDWORD        unnamedParam2
);

매개 변수

[in, out] unnamedParam1

출력 시 국가/지역별 전화 걸기 정보와 국가/지역 설명 문자열에 대한 추가 바이트를 수신하는 RASCTRYINFO 구조체에 대한 포인터입니다.

입력 시 구조체의 dwSize 멤버를 sizeof(RASCTRYINFO)로 설정하여 구조체의 버전을 식별합니다. 또한 dwCountryId 멤버를 정보를 가져올 국가/지역의 TAPI 국가/지역 식별자로 설정합니다.

버퍼에 256바이트 이상을 할당합니다.

[in, out] unnamedParam2

입력 시 lpRasCtryInfo 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정하는 변수에 대한 포인터입니다.

출력에서 이 변수는 필요한 바이트 수를 받습니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 다음 오류 코드 또는 라우팅 및 원격 액세스 오류 코드 또는 Winerror.h의 값 중 하나입니다.

값 의미
ERROR_INVALID_USER_BUFFER
 lpRasCtryInfo로 지정된 주소 또는 버퍼가 잘못되었습니다.
ERROR_INVALID_PARAMETER
 lpRasCtryInfo가 가리키는 구조체의 dwCountryId 멤버가 유효한 값이 아닙니다.
ERROR_BUFFER_TOO_SMALL
 lpdwSize 매개 변수로 지정된 lpRasCtryInfo 버퍼의 크기가 dwCountryId 멤버로 식별된 국가/지역에 대한 정보를 저장할 만큼 크지 않았습니다. 함수는 lpdwSize가 가리키는 변수에 필요한 버퍼 크기를 반환합니다.
ERROR_TAPI_CONFIGURATION
 TAPI 하위 시스템 정보가 손상되었습니다.

설명

Windows 전화 통신 목록의 모든 국가/지역에 대한 정보를 열거하려면 초기 RasGetCountryInfo 호출에서 RASCTRYINFO 구조체의 dwCountryId 멤버를 1로 설정합니다. 이로 인해 함수는 목록의 첫 번째 국가/지역에 대한 정보를 반환합니다. dwNextCountryID 멤버에 반환된 값은 목록에서 다음 국가/지역의 국가/지역 식별자입니다. dwNextCountryID가 0을 반환하여 목록의 마지막 국가/지역을 나타낼 때까지 RasGetCountryInfo에 대한 반복 호출에서 이 값을 사용합니다.

참고

ras.h 헤더는 RAsGetCountryInfo를 별칭으로 정의하여 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 ras.h
라이브러리 Rasapi32.lib
DLL Rasapi32.dll

추가 정보

RASCTRYINFO

RAS(원격 액세스 서비스) 개요

원격 액세스 서비스 함수