ITfInputProcessorProfileMgr::GetProfile-Methode (msctf.h)

Die ITfInputProcessorProfileMgr::GetProfile-Methode gibt die Informationen des Profil- oder Tastaturlayouts des angegebenen Textdiensts in TF_INPUTPROCESSORPROFILE Struktur zurück.

Syntax

HRESULT GetProfile(
  [in]  DWORD                    dwProfileType,
  [in]  LANGID                   langid,
  [in]  REFCLSID                 clsid,
  [in]  REFGUID                  guidProfile,
  [in]  HKL                      hkl,
  [out] TF_INPUTPROCESSORPROFILE *pProfile
);

Parameter

[in] dwProfileType

[in] Der Typ dieses Profils. Dies ist einer dieser Werte.

Wert	Bedeutung
TF_PROFILETYPE_INPUTPROCESSOR	Dies ist ein Textdienst.
TF_PROFILETYPE_KEYBOARDLAYOUT	Dies ist ein Tastaturlayout.

[in] langid

[in] Die Sprach-ID des zu aktivierenden Profils.

[in] clsid

[in] Die CLSID des Textdiensts des zu aktivierenden Profils. Dies muss CLSID_NULL werden, wenn dwProfileType TF_PROFILETYPE_KEYBOARDLAYOUT ist.

[in] guidProfile

[in] Das guidProfile des zu aktivierenden Profils. Dies muss GUID_NULL werden, wenn dwProfileType TF_PROFILETYPE_KEYBOARDLAYOUT ist.

[in] hkl

[in] Der Griff des Tastaturlayouts. Dies muss NULL sein, wenn dwProfileType TF_PROFILETYPE_INPUTPROCESSOR ist.

[out] pProfile

[out] Der Puffer, der TF_INPUTPROCESSORPROFILE empfangen soll.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
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