ToUnicodeEx

지정 된 가상 키 코드와 해당 유니코드 문자 또는 문자 키보드 상태를 변환 하는 ToUnicodeEx 함수.

ToUnicodeEx ( int UINT  wVirtKey, / / 가상 키 코드UINTwScanCode, / / 코드를 스캔PBYTElpKeyState, / / 키 상태 배열LPWSTRpwszBuff, / / 번역 키 버퍼 intcchBuff, / / 번역된 키 버퍼의 크기UINTwFlags, / / 함수 컨디셔닝 플래그 설정 HKLdwhkl / / 키보드 레이아웃 핸들);
 

매개 변수

wVirtKey
변환할 가상 키 코드를 지정 합니다.
wScanCode
번역 될 키의 하드웨어 검색 코드를 지정 합니다. 키 야 하는 경우이 값의 상위 비트 설정.
lpKeyState
현재 키보드 상태를 포함 하는 256 바이트 배열 포인터입니다. 하나의 키의 상태를 포함 하는 배열에 있는 각 요소 (바이트). 키는 아래로 바이트의 상위 비트를 설정 하는 경우.
pwszBuff
변환 된 유니코드 문자 또는 문자를 수신 하는 버퍼에 대 한 포인터.
cchBuff
PwszBuff 매개 변수에서 가리키는 버퍼의 문자에서 크기를 지정 합니다.
wFlags
비트 집합 함수의 동작 조건이 플래그. 메뉴가 활성화 되어 있는 경우에 비트 0을 설정 합니다. 1부터 31 비트는 예약.
dwhkl
주어진된 코드를 변환 하는 데 키보드 레이아웃을 처리 합니다. 이 매개 변수는 이전에 LoadKeyboardLayout 함수에서 반환 된 키보드 레이아웃 핸들 수 있습니다.

반환 값

함수는 다음 값 중 하나를 반환 합니다.

의미
-1 지정된 된 가상 키는 죽은 키 문자 (악센트 또는 분음 부호)입니다. 이 값은 여러 문자가 입력 되었습니다 및 키보드 상태에 저장 하는 경우에 키보드 레이아웃에 관계 없이 반환 됩니다. 만약에 가능 하다 면, 유니코드 자판도 함께 함수 pwszBuffer에 의해 지정 된 버퍼에 죽은 키 문자 간격 버전을 작성 했습니다. 예를 들어, 함수 NON_SPACING 급성 (0x0301) 문자 보다는 문자 간격 심한 (0x00B4)를 기록.
0 지정된 된 가상 키 키보드의 현재 상태에 대 한 아무 번역을 하고있다. 아무것도 pwszBuffer 에 의해 지정 된 버퍼에 기록 된.
1 한 문자 pwszBuffer 에 의해 지정 된 버퍼에 기록 된.
2 명 이상 두 개 이상의 문자는 pwszBuff에 의해 지정 된 버퍼에 작성 되었습니다. 이 대 한 가장 일반적인 원인은 단일 문자를 지정 된 가상 키와 자판 배열에 저장 된 죽은 키 문자 (악센트 또는 분음 부호)를 결합 될.

주의

ToUnicodeEx 함수에 제공 된 매개 변수는 가상 키 코드를 변환 하는 때문에 이전 죽은 키 자판 배열에 저장 됩니다 충분 하지 않을 수도 있습니다.

일반적으로, ToUnicodeEx 는 가상 키 코드를 기반으로 하는 번역을 수행 합니다. 그러나 어떤 경우에, 비트 15 wScanCode 매개 변수는 사용할 수 있습니다 키 및 주요 릴리스 사이 구별 하.

QuickInfo

nbsp;?Windows &NT: 버전 4.0 이상이 필요 합니다.
Windows:지원 되지 않습니다.
Windows CE:지원 되지 않습니다.
헤더:Winuser.h에서 선언합니다.
가져오기 라이브러리:User32.lib를 사용 하 여.

참고 항목

키보드 입력 개요, 키보드 입력 기능, ToAscii, ToUnicode, VkKeyScan

 

Index