VerLanguageNameA 함수(winver.h)
지정된 이진 Microsoft 언어 식별자와 연결된 언어에 대한 설명 문자열을 검색합니다.
구문
DWORD VerLanguageNameA(
[in] DWORD wLang,
[out] LPSTR szLang,
[in] DWORD cchLang
);
매개 변수
[in] wLang
형식:DWORD
이진 언어 식별자입니다. 언어 식별자의 전체 목록은 언어 식별자를 참조하세요.
예를 들어 언어 식별자 0x040A 연결된 설명 문자열은 "스페인어(번체 정렬)"입니다. 식별자를 알 수 없는 경우 szLang 매개 변수는 기본 문자열("언어 중립")을 가리킵니다.
[out] szLang
형식: LPTSTR
wLang 매개 변수로 지정된 언어입니다.
[in] cchLang
형식:DWORD
szLang이 가리키는 버퍼의 크기(문자)입니다.
반환 값
형식:DWORD
반환 값은 버퍼에 반환된 문자열의 크기(문자)입니다. 이 값에는 종료 null 문자가 포함되지 않습니다. 설명 문자열이 버퍼보다 작거나 같은 경우 전체 설명 문자열이 버퍼에 있습니다. 설명 문자열이 버퍼보다 크면 설명 문자열이 버퍼 길이로 잘립니다.
오류가 발생하면 반환 값은 0입니다. 알 수 없는 언어 식별자는 오류를 생성하지 않습니다.
설명
이 함수는 16비트, 32비트 및 64비트 파일 이미지에서 작동합니다.
일반적으로 설치 프로그램은 이 함수를 사용하여 VerQueryValue 함수에서 반환된 언어 식별자를 번역합니다. 텍스트 문자열은 사용자에게 언어 충돌이 발생할 경우 진행하는 방법을 묻는 대화 상자에서 사용할 수 있습니다.
참고
winver.h 헤더는 VERLanguageName을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winver.h(Windows.h 포함) |
| 라이브러리 | Version.lib |
| DLL | Api-ms-win-core-localization-l1-2-1.dll |