Metodo ITfCategoryMgr::FindClosestCategory (msctf.h)

  • Articolo

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