共用方式為

iTfCategoryMgr：：FindClosestCategory 方法 (msctf.h)

  • 發行項

從類別清單中尋找最接近指定 GUID 的類別。

語法

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

參數

[in] rguid

指定要尋找最接近類別之 GUID 的位址。

[out] pcatid

接收最接近類別之 CATID 之 GUID 的指標。

[in] ppcatidList

指標的指標，指定要搜尋最接近類別的 CATID 陣列。

[in] ulCount

指定 ppcatidList 參數陣列中的專案數目。

傳回值

這個方法可以傳回下列其中一個值。

值 描述
S_OK
 方法會從類別清單中取得最接近的類別，或者方法無法從清單中取得類別，並指出這個方法具有 GUID_Null的 pcatid 參數指標。
S_FALSE
 方法找不到所指定 GUID 的類別，並使用 GUID_Null的 pcatid 參數指標發出訊號。
E_FAIL
 方法無法存取內部資料表。
E_INVALIDARG
 指定的pcatid參數在輸入時為Null，或ulCount參數為非零時包含Null元素的類別清單。
E_OUTOFMEMORY
 記憶體不足，無法執行作業。

備註

在兩種模式的其中一種中，選擇最接近 GUID 的類別。 在第一個模式中，方法會收到非空白類別清單。 如果清單不包含包含GUID的類別，它會從該清單中選擇第一個相符的CATID或GUID_Null。 在第二個模式中，它會收到空的類別清單。 如果沒有任何類別包含GUID，它會選擇包含GUID的第一個類別，或GUID_Null。

需求

   
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 msctf.h
Dll Msctf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0

另請參閱

ITfCategoryMgr 介面、 ITfCategoryMgr：：EnumCategoriesInItem、 ITfCategoryMgr：：EnumItemsInCategory、 ITfCategoryMgr：：RegisterCategory