通过

ITfCategoryMgr：：FindClosestCategory 方法 (msctf.h)

  • 项目

从类别列表中查找最接近指定 GUID 的类别。

语法

HRESULT FindClosestCategory(
  [in]  REFGUID    rguid,
  [out] GUID       *pcatid,
  [in]  const GUID **ppcatidList,
  [in]  ULONG      ulCount
);

parameters

[in] rguid

指定要查找其最接近类别的 GUID 的地址。

[out] pcatid

指向接收最接近类别的 CATID 的 GUID 的指针。

[in] ppcatidList

指向指针的指针，该指针指定要搜索最接近的类别的 CATID 数组。

[in] ulCount

指定 ppcatidList 参数数组中的元素数。

返回值

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

值 说明
S_OK
 方法从类别列表中获取了最接近的类别，或者方法无法从列表中获取类别，并使用指向GUID_NULL的 pcatid 参数指针来指示这一点。
S_FALSE
 方法找不到指定 GUID 的类别，并使用指向GUID_NULL的 pcatid 参数指针发出信号。
E_FAIL
 方法无法访问内部表。
E_INVALIDARG
 指定的 pcatid 参数在输入时为 NULL，或者当 ulCount 参数为非零时，类别列表包含 NULL 元素。
E_OUTOFMEMORY
 内存不足，无法执行操作。

注解

在两种模式之一中选择最接近 GUID 的类别。 在第一种模式下，方法接收非空类别列表。 它会从该列表中选择第一个匹配 的 CATID ，如果列表不包含包含 GUID 的类别，则GUID_NULL。 第二种模式接收空的类别列表。 它选择包含 GUID 的第一个类别，如果没有类别包含 GUID ，则选择GUID_NULL。

要求

   
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITfCategoryMgr 接口、 ITfCategoryMgr：：EnumCategoriesInItem、 ITfCategoryMgr：：EnumItemsInCategory、 ITfCategoryMgr：：RegisterCategory