RasGetCountryInfoA 함수(ras.h)
RasGetCountryInfo 함수는 국가/지역의 Windows 전화 통신 목록에서 국가/지역별 전화 걸기 정보를 검색합니다.
국가/지역별 전화 걸기 정보 및 TAPI(전화 통신 애플리케이션 프로그래밍 인터페이스) 국가/지역 식별자에 대한 자세한 내용은 SDK(Platform Software Development Kit)의 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 |
참고 항목
RASCTRYINFO
RAS(원격 액세스 서비스) 개요
원격 액세스 서비스 함수