Metodo ITfCategoryMgr::FindClosestCategory (msctf.h)

Articolo
03/08/2023

Trova la categoria più vicina al GUID specificato da un elenco di categorie.

Sintassi

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

Parametri

[in] rguid

Specifica l'indirizzo del GUID per cui trovare la categoria più vicina.

[out] pcatid

Puntatore al GUID che riceve il CATID per la categoria più vicina.

[in] ppcatidList

Puntatore a un puntatore che specifica una matrice di CATID per cercare la categoria più vicina.

[in] ulCount

Specifica il numero di elementi nella matrice del parametro ppcatidList .

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo ha ottenuto la categoria più vicina dall'elenco delle categorie oppure il metodo non è riuscito a ottenere una categoria dall'elenco e indica che con un puntatore ai parametri pcatid per GUID_NULL.
S_FALSE	Il metodo non è riuscito a trovare una categoria per il GUID specificato e segnala questo metodo con un puntatore ai parametri pcatid per GUID_NULL.
E_FAIL	Il metodo non può accedere alla tabella interna.
E_INVALIDARG	Il parametro pcatid specificato è null in input o l'elenco di categorie contiene un elemento NULL quando il parametro ulCount è diverso da zero.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.

Commenti

La categoria più vicina a un GUID viene scelta in una delle due modalità. Nella prima modalità, il metodo riceve un elenco di categorie non vuoto. Sceglie il primo CATID corrispondente da tale elenco o GUID_NULL se l'elenco non contiene una categoria contenente il GUID . Nella seconda modalità riceve un elenco di categorie vuoto. Sceglie la prima categoria che contiene il GUID o GUID_NULL se nessuna categoria contiene il GUID .

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

Interfaccia ITfCategoryMgr, ITfCategoryMgr ::EnumCategoriesInItem, ITfCategoryMgr::EnumItemsInCategory, ITfCategoryMgr::RegisterCategory

Condividi tramite