ImmGetCandidateListW 함수(imm.h)

후보 목록을 검색합니다.

구문

DWORD ImmGetCandidateListW(
                  HIMC            unnamedParam1,
  [in]            DWORD           deIndex,
  [out, optional] LPCANDIDATELIST lpCandList,
  [in]            DWORD           dwBufLen
);

매개 변수

unnamedParam1

[in] deIndex

후보 목록의 인덱스(0부터 시작)입니다.

[out, optional] lpCandList

함수가 후보 목록을 검색하는 CANDIDATELIST 구조체에 대한 포인터입니다.

[in] dwBufLen

후보 목록을 받을 버퍼의 크기(바이트)입니다. 함수가 출력 버퍼의 필요한 크기만 반환하는 경우 애플리케이션은 이 매개 변수에 대해 0을 지정할 수 있습니다.

반환 값

성공하면 후보 목록 버퍼에 복사된 바이트 수를 반환합니다. 애플리케이션이 dwBufLen 매개 변수에 대해 0을 제공한 경우 함수는 후보 목록 버퍼에 필요한 크기를 반환합니다.

함수가 성공하지 못하면 0을 반환합니다.

설명

참고

imm.h 헤더는 ImmGetCandidateList를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만],동아시아 언어 지원이 설치되었습니다.
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	imm.h(Immdev.h, Windows.h 포함)
라이브러리	Imm32.lib
DLL	Imm32.dll

참고 항목

후보 목록

입력 메서드 관리자

입력 메서드 관리자 함수