ITfCategoryMgr::FindClosestCategory method (msctf.h)

Artikel
03/08/2023

Menemukan kategori yang paling dekat dengan GUID yang ditentukan dari daftar kategori.

Sintaks

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

Parameter

[in] rguid

Menentukan alamat GUID untuk menemukan kategori terdekat.

[out] pcatid

Arahkan ke GUID yang menerima CATID untuk kategori terdekat.

[in] ppcatidList

Penunjuk ke penunjuk yang menentukan array CATID untuk mencari kategori terdekat.

[in] ulCount

Menentukan jumlah elemen dalam array parameter ppcatidList .

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode ini memperoleh kategori terdekat dari daftar kategori, atau metode tidak dapat memperoleh kategori dari daftar dan menunjukkan ini dengan penunjuk parameter pcatid ke GUID_NULL.
S_FALSE	Metode tidak dapat menemukan kategori untuk GUID yang ditentukan dan memberi sinyal ini dengan penunjuk parameter pcatid ke GUID_NULL.
E_FAIL	Metode tidak dapat mengakses tabel internal.
E_INVALIDARG	Parameter pcatid yang ditentukan adalah NULL pada input, atau daftar kategori yang berisi elemen NULL ketika parameter ulCount bukan nol.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi.

Keterangan

Kategori terdekat dengan GUID dipilih dalam salah satu dari dua mode. Dalam mode pertama, metode menerima daftar kategori yang tidak kosong. Ini memilih CATID pertama yang cocok dari daftar tersebut atau GUID_NULL jika daftar tidak berisi kategori yang berisi GUID . Dalam mode kedua, ia menerima daftar kategori kosong. Ini memilih kategori pertama yang berisi GUID atau GUID_NULL jika tidak ada kategori yang berisi GUID .

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	msctf.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional

Lihat juga

Antarmuka ITfCategoryMgr, ITfCategoryMgr::EnumCategoriesInItem, ITfCategoryMgr::EnumItemsInCategory, ITfCategoryMgr::RegisterCategory

Bagikan melalui