DownlevelGetParentLocaleName 함수

제공된 로캘의 부모에 대한 로캘 이름을 검색합니다.

참고 항목

이 함수는 Windows Vista 이전 운영 체제에서 실행되는 애플리케이션에서만 사용됩니다. 사용하려면 다운로드 패키지가 필요합니다. Windows Vista 이상에서만 실행되는 애플리케이션은 LCType이 LOCALE_SPARENT 설정된 GetLocaleInfo 를 호출해야 합니다.

 

구문

int DownlevelGetParentLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName
);

매개 변수

로캘 [in]

로캘의 로캘 식별자 입니다. MAKELCID 매크로를 사용하여 로캘 식별자를 만들거나 다음 미리 정의된 값 중 하나를 사용할 수 있습니다.

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Windows Vista 이상: 다음 사용자 지정 로캘 식별자도 지원됩니다.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

lpName [out]

함수가 부모 로캘 이름을 검색하는 버퍼 또는 다음 미리 정의된 값 중 하나를 가리키는 포인터입니다. cchName이 0으로 설정된 경우 이 매개 변수는 NULL로 설정됩니다.

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

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
헤더	Nlsdl.h
DLL	NlsMap.dll

참고 항목

국가별 언어 지원

국가별 언어 지원 함수

로캘 데이터 매핑

GetLocaleInfo