IInkLineInfo::GetCandidate 메서드(msinkaut.h)

인식 결과 목록에서 하나의 인식 대체를 반환합니다.

구문

HRESULT GetCandidate(
  [in]  UINT   nCandidateNum,
  [out] LPWSTR pwcRecogWord,
  [out] UINT   *pcwcRecogWord,
  [in]  DWORD  dwFlags
);

[in] nCandidateNum

검색할 대체 목록 항목의 인덱스(0부터 시작)입니다.

[out] pwcRecogWord

선택한 인식 대체 항목을 저장할 버퍼입니다. pwcRecogWord가 NULL인 경우 메서드는 인식 대체 단어를 검색하려고 시도하지 않습니다.

[out] pcwcRecogWord

pwcRecogWord 버퍼의 길이를 유니코드 문자로 전달하고 버퍼에 복사된 유니코드 문자 수를 반환합니다.

[in] dwFlags

사용되지 않습니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_FAIL	nCandidateNum 인덱스는 인식 대체 수보다 큽니다.
ERROR_MORE_DATA	pwcRecogWord 버퍼가 인식 대체를 수락할 만큼 크지 않습니다.

pwcRecogWord 매개 변수가 null이면 메서드는 인식 대체 단어를 검색하지 않고 pwcRecogWord만 인식 대체 문자 수로 설정합니다.

pwcRecogWord 버퍼가 인식 대체를 포함할 만큼 충분히 크지 않은 경우 pwcRecogWord 버퍼는 인식 대체의 첫 번째 pwcRecogWord 문자 수로 채워집니다.