다음을 통해 공유

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 매개 변수의 배열에 있는 요소 수를 지정합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값 Description
S_OK
 메서드는 범주 목록에서 가장 가까운 범주를 가져오거나 메서드가 목록에서 범주를 가져올 수 없으며 GUID_NULL 대한 pcatid 매개 변수 포인터를 사용하여 이를 나타냅니다.
S_FALSE
 메서드가 지정된 GUID에 대한 범주를 찾을 수 없으며 GUID_NULL 대한 pcatid 매개 변수 포인터를 사용하여 이를 알릴 수 있습니다.
E_FAIL
 메서드는 내부 테이블에 액세스할 수 없습니다.
E_INVALIDARG
 지정된 pcatid 매개 변수가 입력 시 NULL이거나, ulCount 매개 변수가 0이 아닌 경우 범주 목록에 NULL 요소가 포함되었습니다.
E_OUTOFMEMORY
 작업을 수행할 메모리가 부족합니다.

설명

GUID에 가장 가까운 범주는 두 가지 모드 중 하나로 선택됩니다. 첫 번째 모드에서 메서드는 비어 있지 않은 범주 목록을 받습니다. 해당 목록에서 일치하는 첫 번째 CATID 를 선택하거나 목록에 GUID 가 포함된 범주가 없는 경우 GUID_NULL. 두 번째 모드에서는 빈 범주 목록을 받습니다. 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