IInkLineInfo：：GetCandidate 方法 (msinkaut.h)

从识别结果列表中返回一个备用识别。

语法

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

[in] nCandidateNum

要检索的备用列表项的从零开始的索引。

[out] pwcRecogWord

要在其中存储所选识别备用的缓冲区。如果 pwcRecogWord 为 NULL，则该方法不会尝试检索识别备用词。

[out] pcwcRecogWord

传递 pwcRecogWord 缓冲区的长度（以 Unicode 字符为单位），并返回复制到缓冲区中的 Unicode 字符数。

[in] dwFlags

未使用。

此方法可以返回其中一个值。

返回代码	说明
S_OK	方法成功。
E_FAIL	nCandidateNum 索引大于替换识别数。
ERROR_MORE_DATA	pwcRecogWord 缓冲区不够大，无法接受识别备用。

如果 pwcRecogWord 参数为 null，则该方法不会尝试检索识别备用词，而只会将 pwcRecogWord 设置为识别备用字符数。

如果 pwcRecogWord 缓冲区不够大，无法包含识别备用项，则 pwcRecogWord 缓冲区将填充识别备用中的第一个 pwcRecogWord 字符数。


最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	msinkaut.h
Library	InkObj.dll