Поделиться через

Метод ITfCategoryMgr::FindClosestCategory (msctf.h)

  • Статья

Находит категорию, ближайшую к указанному GUID, из списка категорий.

Синтаксис

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

Параметры

[in] rguid

Указывает адрес GUID, для которого требуется найти ближайшую категорию.

[out] pcatid

Указатель на GUID , получающий CATID для ближайшей категории.

[in] ppcatidList

Указатель на указатель, указывающий массив идентификаторов CATID для поиска ближайшей категории.

[in] ulCount

Указывает количество элементов в массиве параметра ppcatidList .

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение Описание
S_OK
 Метод получил ближайшую категорию из списка категорий или не смог получить категорию из списка и указывает на это с помощью pcatid параметра указатель на GUID_NULL.
S_FALSE
 Методу не удалось найти категорию для указанного GUID и сообщает об этом с помощью указателя параметра pcatid на GUID_NULL.
E_FAIL
 Метод не может получить доступ к внутренней таблице.
E_INVALIDARG
 Указанный параметр pcatid имеет значение NULL для входных данных, или список категорий содержал элемент NULL , если параметр ulCount был ненулевым.
E_OUTOFMEMORY
 Недостаточно памяти для выполнения операции.

Комментарии

Наиболее близкая к GUID категория выбирается в одном из двух режимов. В первом режиме метод получает список непустых категорий. Он выбирает первый соответствующий CATID из этого списка или GUID_NULL, если список не содержит категорию, содержащую GUID . Во втором режиме он получает пустой список категорий. Он выбирает первую категорию, содержащую GUID или GUID_NULL, если ни один из категорий не содержит GUID .

Требования

   
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header msctf.h
DLL Msctf.dll
Распространяемые компоненты TSF 1.0 в Windows 2000 Professional

См. также раздел

Интерфейс ITfCategoryMgr, ITfCategoryMgr::EnumCategoriesInItem, ITfCategoryMgr::EnumItemsInCategory, ITfCategoryMgr::RegisterCategory