ITfCategoryMgr::FindClosestCategory-Methode (msctf.h)

Artikel
08/24/2023

Sucht die Kategorie, die der angegebenen GUID am nächsten ist, aus einer Liste von Kategorien.

Syntax

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

Parameter

[in] rguid

Gibt die Adresse der GUID an, für die die nächstgelegene Kategorie gefunden werden soll.

[out] pcatid

Zeiger auf die GUID , die die CATID für die nächstgelegene Kategorie empfängt.

[in] ppcatidList

Zeiger auf einen Zeiger, der ein Array von CATIDs angibt, die nach der nächstgelegenen Kategorie gesucht werden sollen.

[in] ulCount

Gibt die Anzahl der Elemente im Array des ppcatidList-Parameters an.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode hat die nächstgelegene Kategorie aus der Liste der Kategorien abgerufen, oder die Methode konnte keine Kategorie aus der Liste abrufen und gibt dies mit einem pcatid-Parameterzeiger auf GUID_NULL an.
S_FALSE	Die -Methode konnte keine Kategorie für die angegebene GUID finden und signalisiert dies mit einem pcatid-Parameterzeiger an GUID_NULL.
E_FAIL	Die -Methode kann nicht auf die interne Tabelle zugreifen.
E_INVALIDARG	Der angegebene pcatid-Parameter war bei der Eingabe NULL , oder die Liste der Kategorien enthielt ein NULL-Element , wenn der ulCount-Parameter ungleich null war.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.

Hinweise

Die kategorie, die einer GUID am nächsten ist, wird in einem von zwei Modi ausgewählt. Im ersten Modus empfängt die -Methode eine nicht leere Kategorieliste. Es wählt die erste übereinstimmende CATID aus dieser Liste oder GUID_NULL, wenn die Liste keine Kategorie enthält, die die GUID enthält. Im zweiten Modus empfängt sie eine leere Kategorieliste. Es wählt die erste Kategorie aus, die die GUID enthält, oder GUID_NULL, wenn keine Kategorie die GUID enthält.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfCategoryMgr-Schnittstelle, ITfCategoryMgr::EnumCategoriesInItem, ITfCategoryMgr::EnumItemsInCategory, ITfCategoryMgr::RegisterCategory

Freigeben über