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

  • Artigo

Localiza a categoria mais próxima do GUID especificado de uma lista de categorias.

Sintaxe

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

Parâmetros

[in] rguid

Especifica o endereço do GUID para o qual encontrar a categoria mais próxima.

[out] pcatid

Ponteiro para o GUID que recebe o CATID para a categoria mais próxima.

[in] ppcatidList

Ponteiro para um ponteiro que especifica uma matriz de CATIDs para pesquisar a categoria mais próxima.

[in] ulCount

Especifica o número de elementos na matriz do parâmetro ppcatidList .

Valor retornado

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método obteve a categoria mais próxima da lista de categorias ou o método não pôde obter uma categoria da lista e indica isso com um ponteiro de parâmetro pcatid para GUID_NULL.
S_FALSE
 O método não pôde encontrar uma categoria para o GUID especificado e sinaliza isso com um ponteiro de parâmetro pcatid para GUID_NULL.
E_FAIL
 O método não pode acessar a tabela interna.
E_INVALIDARG
 O parâmetro pcatid especificado era NULL na entrada ou a lista de categorias continha um elemento NULL quando o parâmetro ulCount não era zero.
E_OUTOFMEMORY
 Não há memória suficiente para executar a operação.

Comentários

A categoria mais próxima de um GUID é escolhida em um dos dois modos. No primeiro modo, o método recebe uma lista de categorias não vazia. Ele escolherá o primeiro CATID correspondente nessa lista ou GUID_NULL se a lista não contiver uma categoria que contenha o GUID . No segundo modo, ele recebe uma lista de categorias vazia. Ele escolhe a primeira categoria que contém o GUID ou GUID_NULL se nenhuma categoria contiver o GUID .

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msctf.h
DLL Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

Interface ITfCategoryMgr, ITfCategoryMgr::EnumCategoriesInItem, ITfCategoryMgr::EnumItemsInCategory, ITfCategoryMgr::RegisterCategory