GetNLSVersion 함수(winnls.h)
식별자가 지정한 로캘에 대해 지정된 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 |