DownlevelGetParentLocaleName 함수
제공된 로캘의 부모에 대한 로캘 이름을 검색합니다.
참고 항목
이 함수는 Windows Vista 이전 운영 체제에서 실행되는 애플리케이션에서만 사용됩니다. 사용하려면 다운로드 패키지가 필요합니다. Windows Vista 이상에서만 실행되는 애플리케이션은 LCType이 LOCALE_SPARENT 설정된 GetLocaleInfo 를 호출해야 합니다.
구문
int DownlevelGetParentLocaleName(
_In_ LCID Locale,
_Out_ LPWSTR lpName,
_In_ int cchName
);
매개 변수
-
로캘 [in]
-
로캘의 로캘 식별자 입니다. MAKELCID 매크로를 사용하여 로캘 식별자를 만들거나 다음 미리 정의된 값 중 하나를 사용할 수 있습니다.
Windows Vista 이상: 다음 사용자 지정 로캘 식별자도 지원됩니다.
-
lpName [out]
-
함수가 부모 로캘 이름을 검색하는 버퍼 또는 다음 미리 정의된 값 중 하나를 가리키는 포인터입니다. cchName이 0으로 설정된 경우 이 매개 변수는 NULL로 설정됩니다.
-
cchName [in]
-
lpName으로 표시된 버퍼의 크기(UTF-16 코드 포인트)입니다. 이 매개 변수의 값이 0이면 함수가 lpName 버퍼를 무시하고 부모 로캘 이름을 포함하는 데 필요한 문자(null 문자 포함)로 버퍼의 크기를 반환합니다.
반환 값
성공하면 종료 null 문자를 포함하여 로캘 이름에 UTF-16 코드 포인트 수를 반환합니다.
이 함수는 성공하지 못하면 0을 반환합니다. 확장 오류 정보를 가져오기 위해 애플리케이션은 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출할 수 있습니다.
- ERROR_INSUFFICIENT_BUFFER. 제공된 버퍼 크기가 충분히 크지 않거나 NULL로 잘못 설정되었습니다.
- ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.
설명
필요한 헤더 파일 및 DLL은 Microsoft 다운로드 센터에서 더 이상 사용할 수 없는 "Microsoft NLS 다운레벨 데이터 매핑 API" 다운로드의 일부입니다. Windows 10 2019년 5월 업데이트 이상 버전에서 ICU 세계화 API를 사용합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 재배포 가능 파일 |
MICROSOFT NLS SP2 이상을 사용하는 Microsoft NLS 다운레벨 데이터 매핑 API onWindows XP |
| 헤더 |
|
| DLL |
|
참고 항목