ITfInputProcessorProfileMgr::GetActiveProfile-Methode (msctf.h)

Diese Methode gibt das aktuelle aktive Profil zurück.

Syntax

HRESULT GetActiveProfile(
  [in]  REFGUID                  catid,
  [out] TF_INPUTPROCESSORPROFILE *pProfile
);

Parameter

[in] catid

[in] Die Kategorie-ID für das Profil. Dies muss GUID_TFCAT_TIP_KEYBOARD sein. Nur GUID_TFCAT_TIP_KEYBOARD wird unterstützt.

[out] pProfile

[out] Der Puffer zum Empfangen der Profilinformationen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Das Profil wurde nicht gefunden oder ist nicht aktiv.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll