ITfCategoryMgr::FindClosestCategory, méthode (msctf.h)

Article
08/24/2023

Recherche la catégorie la plus proche du GUID spécifié dans une liste de catégories.

Syntaxe

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

Paramètres

[in] rguid

Spécifie l’adresse du GUID pour lequel trouver la catégorie la plus proche.

[out] pcatid

Pointeur vers le GUID qui reçoit le CATID de la catégorie la plus proche.

[in] ppcatidList

Pointeur vers un pointeur qui spécifie un tableau de CATIDs pour rechercher la catégorie la plus proche.

[in] ulCount

Spécifie le nombre d’éléments dans le tableau du paramètre ppcatidList .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a obtenu la catégorie la plus proche de la liste des catégories, ou la méthode n’a pas pu obtenir une catégorie à partir de la liste et l’indique avec un pointeur de paramètre pcatid vers GUID_NULL.
S_FALSE	La méthode n’a pas pu trouver une catégorie pour le GUID spécifié et signale cela avec un pointeur de paramètre pcatid vers GUID_NULL.
E_FAIL	La méthode ne peut pas accéder à la table interne.
E_INVALIDARG	Le paramètre pcatid spécifié était NULL lors de l’entrée, ou la liste des catégories contenait un élément NULL lorsque le paramètre ulCount était différent de zéro.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.

Notes

La catégorie la plus proche d’un GUID est choisie dans l’un des deux modes. Dans le premier mode, la méthode reçoit une liste de catégories non vide. Il choisit le premier CATID correspondant dans cette liste ou GUID_NULL si la liste ne contient pas de catégorie qui contient le GUID . Dans le deuxième mode, il reçoit une liste de catégories vide. Il choisit la première catégorie qui contient le GUID ou GUID_NULL si aucune catégorie ne contient le GUID .

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

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

Partager via