GetNLSVersion 함수(winnls.h)

아티클
03/08/2023

식별자가 지정한 로캘에 대해 지정된 NLS 기능의 현재 버전에 대한 정보를 검색합니다.

참고 상호 운용성을 위해 Microsoft가 새 로캘에 대한 로캘 식별자 대신 로캘 이름을 사용하도록 마이그레이션하기 때문에 애플리케이션은 GetNLSVersionEx 함수를 GetNLSVersion 에 선호해야 합니다. 이 권장 사항은 특히 GetNLSVersionEx 가 정렬 동작이 변경되었는지 확인하기에 충분한 정보를 검색하는 사용자 지정 로캘에 적용됩니다. Windows Vista 이상에서만 실행되는 모든 애플리케이션은 GetNLSVersionEx를 사용하거나 GetNLSVersion을 호출하여 추가 정렬 버전 관리 데이터를 가져올 때 적어도 NLSVERSIONINFOEX 구조를 전달해야 합니다.

구문

BOOL GetNLSVersion(
  [in]      NLS_FUNCTION     Function,
  [in]      LCID             Locale,
  [in, out] LPNLSVERSIONINFO lpVersionInformation
);

매개 변수

[in] Function

쿼리할 NLS 기능입니다. 이 값은 COMPARE_STRING 합니다. SYSNLS_FUNCTION 열거형을 참조하세요.

[in] Locale

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

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

[in, out] lpVersionInformation

NLSVERSIONINFO 구조체에 대한 포인터입니다. 애플리케이션은 dwNLSVersionInfoSize 멤버 sizeof(NLSVERSIONINFO)를 로 초기화해야 합니다.

참고 Windows Vista 이상에서 함수는 NLSVERSIONINFOEX 구조에서 버전 정보를 제공할 수 있습니다.

반환 값

애플리케이션이 lpVersionInformation에 유효한 값을 제공한 경우에만 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 확장된 오류 정보를 가져오기 위해 애플리케이션은 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출할 수 있습니다.

ERROR_INSUFFICIENT_BUFFER. 제공된 버퍼 크기가 충분히 크지 않거나 NULL로 잘못 설정되었습니다.
ERROR_INVALID_FLAGS. 플래그에 제공된 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

설명

이 함수를 사용하면 Active Directory와 같은 애플리케이션에서 NLS 변경이 특정 인덱스 테이블에 사용되는 로캘 식별자에 영향을 미치는지 확인할 수 있습니다. 그렇지 않으면 테이블을 다시 인덱싱할 필요가 없습니다. 자세한 내용은 애플리케이션에서 정렬 처리를 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winnls.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll