Share via

Método ITfCategoryMgr::FindClosestCategory (msctf.h)

  • Artículo

Busca la categoría más cercana al GUID especificado de una lista de categorías.

Sintaxis

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

Parámetros

[in] rguid

Especifica la dirección del GUID para el que se va a buscar la categoría más cercana.

[out] pcatid

Puntero al GUID que recibe el CATID de la categoría más cercana.

[in] ppcatidList

Puntero a un puntero que especifica una matriz de CATID para buscar la categoría más cercana.

[in] ulCount

Especifica el número de elementos de la matriz del parámetro ppcatidList .

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
 El método obtuvo la categoría más cercana de la lista de categorías o el método no pudo obtener una categoría de la lista e indica esto con un puntero de parámetro pcatid a GUID_NULL.
S_FALSE
 El método no pudo encontrar una categoría para el GUID especificado y lo señala con un puntero de parámetro pcatid a GUID_NULL.
E_FAIL
 El método no puede tener acceso a la tabla interna.
E_INVALIDARG
 El parámetro pcatid especificado era NULL en la entrada o la lista de categorías contenía un elemento NULL cuando el parámetro ulCount era distinto de cero.
E_OUTOFMEMORY
 No hay memoria suficiente para realizar la operación.

Comentarios

La categoría más cercana a un GUID se elige en uno de los dos modos. En el primer modo, el método recibe una lista de categorías no vacía. Elige el primer CATID coincidente de esa lista o GUID_NULL si la lista no contiene una categoría que contenga el GUID . En el segundo modo, recibe una lista de categorías vacía. Elige la primera categoría que contiene el GUID o GUID_NULL si ninguna categoría contiene el GUID .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado msctf.h
Archivo DLL Msctf.dll
Redistribuible TSF 1.0 en Windows 2000 Professional

Consulte también

Interfaz ITfCategoryMgr, ITfCategoryMgr::EnumCategoriesInItem, ITfCategoryMgr::EnumItemsInCategory, ITfCategoryMgr::RegisterCategory