ITfInputProcessorProfileMgr::RegisterProfile-Methode (msctf.h)

Artikel
08/24/2023

Die ITfInputProcessorProfileMgr::RegisterProfile-Methode registriert den Textdienst und das Profil.

Syntax

HRESULT RegisterProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
       const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
       const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex,
  [in] HKL         hklsubstitute,
  [in] DWORD       dwPreferredLayout,
  [in] BOOL        bEnabledByDefault,
  [in] DWORD       dwFlags
);

Parameter

[in] rclsid

[in] CLSID des Textdiensts.

[in] langid

[in] Die Sprach-ID des Profils.

[in] guidProfile

[in] Die GUID zum Identifizieren des Profils.

pchDesc

[in, size_is(cchDesc)] Die Beschreibung des Profils.

[in] cchDesc

[in] Die Länge von pchDesc.

pchIconFile

[in, size_is(cchFile] Der vollständige Pfad der Symboldatei.

[in] cchFile

[in] Die Länge von pchIconFile.

[in] uIconIndex

[in] Der Symbolindex der Symboldatei für dieses Profil.

[in] hklsubstitute

[in] Der Ersatz-hkl dieses Profils.

[in] dwPreferredLayout

[in] Nicht verwendet. dies muss 0 sein.

[in] bEnabledByDefault

[in] True, wenn dieses Profil standardmäßig aktiviert ist.

[in] dwFlags

[in] Die Kombination der folgenden Bits:

Wert	Bedeutung
TF_RP_HIDDENINSETTINGUI	Dieses Profil wird in der Einstellungsoberfläche nicht angezeigt.
TF_RP_LOCALPROCESS	Dieses Profil ist nur für den lokalen Prozess verfügbar.
TF_RP_LOCALTHREAD	Dieses Profil ist nur im lokalen Thread verfügbar.

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


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