ITfThreadMgr::GetFunctionProvider-Methode (msctf.h)

Ruft das angegebene Funktionsanbieterobjekt ab.

Syntax

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

Parameter

[in] clsid

CLSID des gewünschten Funktionsanbieters. Dies kann die CLSID eines Funktionsanbieters sein, der für den aufrufenden Thread registriert ist, oder einer der folgenden vordefinierten Werte.

Wert	Bedeutung
GUID_SYSTEM_FUNCTIONPROVIDER	Ruft den TSF-Systemfunktionsanbieter ab.
GUID_APP_FUNCTIONPROVIDER	Ruft den von der aktuellen Anwendung implementierten Funktionsanbieter ab. Dieses Objekt ist nicht verfügbar, wenn die Anwendung sich nicht selbst als Funktionsanbieter registriert.

[out] ppFuncProv

Zeiger auf eine ITfFunctionProvider-Schnittstelle , die den Funktionsanbieter empfängt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TF_E_NOPROVIDER	Es war kein Funktionsanbieter verfügbar, der clsid entspricht.
E_FAIL	GUID_SYSTEM_FUNCTIONPROVIDER wurde angefordert, kann aber nicht abgerufen werden.

Hinweise

Ein Funktionsanbieter registriert sich, indem die TSF-Manager-Methode ITfSourceSingle::AdviseSingleSink mit IID_ITfFunctionProvider aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfFunctionProvider

ITfSourceSingle::AdviseSingleSink

ITfThreadMgr

ITfThreadMgr::EnumFunctionProviders