Freigeben über

ITfInputProcessorProfileMgr::GetProfile-Methode (msctf.h)

  • Artikel

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