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 パラメーターが 0 以外の場合に、カテゴリのリストに NULL 要素が含まれていました。
E_OUTOFMEMORY
 操作を実行するためのメモリが不足しています。

解説

GUID に最も近いカテゴリは、2 つのモードのいずれかで選択されます。 最初のモードでは、 メソッドは空でないカテゴリ リストを受け取ります。 そのリストから最初に一致する CATID を 選択するか、リストに GUID を含むカテゴリが含まれていない場合はGUID_NULLします。 2 番目のモードでは、空のカテゴリ リストを受け取ります。 GUID を含む最初のカテゴリを選択するか、GUID が含まれているカテゴリがない場合はGUID_NULLします。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー msctf.h
[DLL] Msctf.dll
再頒布可能パッケージ Windows 2000 Professional 上の TSF 1.0

関連項目

ITfCategoryMgr インターフェイス、 ITfCategoryMgr::EnumCategoriesInItem、 ITfCategoryMgr::EnumItemsInCategory、 ITfCategoryMgr::RegisterCategory