ITfInputProcessorProfiles::AddLanguageProfile-Methode (msctf.h)

Artikel
08/24/2023

Erstellt ein Sprachprofil, das aus einem bestimmten Textdienst und einem bestimmten Sprachbezeichner besteht.

Syntax

HRESULT AddLanguageProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
  [in] const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
  [in] const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex
);

Parameter

[in] rclsid

Enthält die Textdienst-CLSID.

[in] langid

Enthält einen LANGID-Wert , der den Sprachbezeichner des Profils angibt, dem der Textdienst hinzugefügt wird. Wenn dieser -1 enthält, wird der Textdienst allen Sprachen hinzugefügt.

[in] guidProfile

Enthält einen GUID-Wert, der das Sprachprofil identifiziert. Dies ist der Wert, der von ITfInputProcessorProfiles::GetActiveLanguageProfile abgerufen wird, wenn das Profil aktiv ist.

[in] pchDesc

Zeiger auf einen WCHAR-Puffer , der die Beschreibungszeichenfolge für den Textdienst im Profil enthält. Dies ist der Textdienstname, der in der Sprachleiste angezeigt wird.

[in] cchDesc

Enthält die Länge in Zeichen der Beschreibungszeichenfolge in pchDesc. Wenn diese -1 enthält, wird pchDescals null-endende Zeichenfolge angenommen.

[in] pchIconFile

Zeiger auf einen WCHAR-Puffer , der den Pfad und Dateinamen der Datei enthält, die das Symbol enthält, das in der Sprachleiste für den Textdienst im Profil angezeigt werden soll. Bei dieser Datei kann es sich um eine ausführbare Datei (.exe), eine DLL-Datei (.dll) oder eine Symboldatei (.ico) handeln.

Dieser Parameter ist optional und kann NULL sein. In diesem Fall wird ein Standardsymbol für den Textdienst angezeigt.

[in] cchFile

Enthält die Länge der Symboldateizeichenfolge in pchIconFile in Zeichen. Wenn diese -1 enthält, wird pchIconFile als null-endende Zeichenfolge angenommen. Dieser Parameter wird ignoriert, wenn pchIconFileNULL ist.

[in] uIconIndex

Enthält den nullbasierten Index des Symbols in pchIconFile , das in der Sprachleiste für den Textdienst im Profil angezeigt werden soll. Dieser Parameter wird ignoriert, wenn pchIconFileNULL ist.

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	pszDesc ist ungültig.

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

ITfInputProcessorProfiles

ITfInputProcessorProfiles::GetActiveLanguageProfile

Freigeben über