ITfThreadMgr2::GetFunctionProvider 메서드(msctf.h)

지정된 함수 공급자 개체를 가져옵니다.

구문

HRESULT GetFunctionProvider(
  [in]  REFCLSID            clsid,
  [out] ITfFunctionProvider **ppFuncProv
);

[in] clsid

원하는 함수 공급자의 CLSID입니다. 호출 스레드에 대해 등록된 함수 공급자의 CLSID 또는 다음 미리 정의된 값 중 하나일 수 있습니다.

값	의미
GUID_SYSTEM_FUNCTIONPROVIDER	TSF 시스템 함수 공급자를 가져옵니다.
GUID_APP_FUNCTIONPROVIDER	현재 애플리케이션에서 구현된 함수 공급자를 가져옵니다. 애플리케이션이 자신을 함수 공급자로 등록하지 않으면 이 개체를 사용할 수 없습니다.

[out] ppFuncProv

함수 공급자를 수신하는 ITfFunctionProvider 인터페이스에 대한 포인터입니다.

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
TF_E_NOPROVIDER	clsid와 일치하는 함수 공급자를 사용할 수 없습니다.
E_FAIL	GUID_SYSTEM_FUNCTIONPROVIDER 요청되었지만 가져올 수 없습니다.

함수 공급자는 IID_ITfFunctionProvider 사용하여 TSF 관리자 ITfSourceSingle::AdviseSingleSink 메서드를 호출하여 등록합니다.