IUserDictionariesRegistrar::RegisterUserDictionary-Methode (spellcheck.h)

Registriert eine Datei, die als Benutzerwörterbuch für den aktuellen Benutzer verwendet werden soll, bis die Registrierung aufgehoben wird.

Syntax

HRESULT RegisterUserDictionary(
  [in] LPCWSTR dictionaryPath,
  [in] LPCWSTR languageTag
);

Parameter

[in] dictionaryPath

Der Pfad der zu registrierenden Wörterbuchdatei.

[in] languageTag

Die Sprache, für die dieses Wörterbuch verwendet werden soll. Wenn sie leer gelassen wird, wird sie für jede Sprache verwendet.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabewert	BESCHREIBUNG
S_OK	Erfolgreiche.
S_FALSE	Die Datei ist bereits für die Sprache registriert.
E_INVALIDARG	Die Datei ist nicht vorhanden oder ungültig oder hat keine gültige Erweiterung (.dic, .exc oder .acl).
E_POINTER	dictionaryPath oder languageTag ist ein NULL-Zeiger.

Hinweise

Der Dateiname muss die Erweiterung .dic (wörter hinzugefügt), .exc (ausgeschlossene Wörter) oder .acl (AutoKorrektur Wortpaare) aufweisen. Die Dateien sind UTF-16 LE-Klartext, die mit der entsprechenden Bytereihenfolgemarkierung (BOM) beginnen müssen. Jede Zeile enthält ein Wort (in den Listen Hinzugefügte und ausgeschlossene Wörter) oder ein Autokorrektur-Paar mit den Wörtern, die durch einen vertikalen Balken ("|") getrennt sind. (in der AutoKorrektur-Wortliste). Die Wortliste, in der das Wörterbuch enthalten ist, wird über die Dateierweiterung abgeleitet.

Eine datei, die für ein Sprachuntertag registriert ist, wird für alle Sprachen, die es enthalten, aufgenommen. Beispielsweise wird ein für "en" registriertes Wörterbuch auch von einer Rechtschreibprüfung "en-US" verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	spellcheck.h

Weitere Informationen

IUserDictionariesRegistrar