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의 값 중 하나입니다.
값 | 의미 |
---|---|
|
lpRasCtryInfo로 지정된 주소 또는 버퍼가 잘못되었습니다. |
|
lpRasCtryInfo가 가리키는 구조체의 dwCountryId 멤버가 유효한 값이 아닙니다. |
|
lpdwSize 매개 변수로 지정된 lpRasCtryInfo 버퍼의 크기가 dwCountryId 멤버로 식별된 국가/지역에 대한 정보를 저장할 만큼 크지 않았습니다. 함수는 lpdwSize가 가리키는 변수에 필요한 버퍼 크기를 반환합니다. |
|
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 |