ImmGetGuideLineA-Funktion (imm.h)
Ruft Informationen zu Fehlern ab. Anwendungen verwenden die Informationen für Benutzerbenachrichtigungen.
Syntax
DWORD ImmGetGuideLineA(
[in] HIMC unnamedParam1,
[in] DWORD dwIndex,
[out, optional] LPSTR lpBuf,
[in] DWORD dwBufLen
);
Parameter
[in] unnamedParam1
Behandeln sie den Eingabekontext.
[in] dwIndex
Typ der abzurufenden Richtlinieninformationen. Dieser Parameter kann einen der folgenden Werte aufweisen.
[out, optional] lpBuf
Zeigen Sie auf einen Puffer, in dem die Funktion die Fehlermeldungszeichenfolge abruft. Dieser Parameter enthält NULL-, wenn dwIndex- nicht GGL_STRING oder GGL_PRIVATE ist oder wenn dwBufLen- auf 0 festgelegt ist.
[in] dwBufLen
Größe des Ausgabepuffers in Bytes. Die Anwendung legt diesen Parameter auf 0 fest, wenn die Funktion die Puffergröße zurückgibt, die zum Empfangen der Fehlermeldungszeichenfolge erforderlich ist, nicht einschließlich des endenden Nullzeichens.
Rückgabewert
Gibt eine Fehlerebene, einen Fehlerindex oder die Größe einer Fehlermeldungszeichenfolge zurück, abhängig vom Wert des dwIndex--Parameters. Wenn dwIndex- GGL_LEVEL ist, ist die Rückgabe einer der folgenden Werte.
| Wert | Bedeutung |
|---|---|
| GL_LEVEL_ERROR | Fehler. Der IME kann möglicherweise nicht fortgesetzt werden. |
| GL_LEVEL_FATAL | Schwerwiegender Fehler. Der IME kann nicht fortgesetzt werden, und Die Daten können verloren gegangen sein. |
| GL_LEVEL_INFORMATION | Kein Fehler. Informationen sind für den Benutzer verfügbar. |
| GL_LEVEL_NOGUIDELINE | Kein Fehler. Entfernen Sie vorherige Fehlermeldung, wenn sie noch sichtbar ist. |
| GL_LEVEL_WARNING | Unerwartete Eingabe oder ein anderes Ergebnis. Der Benutzer sollte gewarnt werden, aber der IME kann fortgesetzt werden. |
Wenn dwIndex- GGL_INDEX ist, ist der Rückgabewert einer der folgenden Werte.
| Wert | Bedeutung |
|---|---|
| GL_ID_CANNOTSAVE | Das Wörterbuch oder die Statistikdaten können nicht gespeichert werden. |
| GL_ID_NOCONVERT | Der IME kann nicht mehr konvertiert werden. |
| GL_ID_NODICTIONARY | Der IME kann das Wörterbuch nicht finden, oder das Wörterbuch hat ein unerwartetes Format. |
| GL_ID_NOMODULE | Der IME kann das erforderliche Modul nicht finden. |
| GL_ID_READINGCONFLICT | Es ist ein Lesekonflikt aufgetreten. Beispielsweise können einige Vokale nicht zusammengestellt werden, um ein Zeichen zu bilden. |
| GL_ID_TOOMANYSTROKE | Es gibt zu viele Striche für ein Zeichen oder eine Klausel. |
| GL_ID_TYPINGERROR | Tippfehler. Der IME kann diese Eingabe nicht verarbeiten. |
| GL_ID_UNKNOWN | Unbekannter Fehler. Verweisen Sie auf die Fehlermeldungszeichenfolge. |
| GL_ID_INPUTREADING | Der IME akzeptiert lesezeicheneingaben vom Endbenutzer. |
| GL_ID_INPUTRADICAL | Der IME akzeptiert radikale Zeicheneingaben des Endbenutzers. |
| GL_ID_INPUTCODE | Der IME akzeptiert zeichencodeeingaben vom Endbenutzer. |
| GL_ID_CHOOSECANDIDATE | Der IME akzeptiert die Auswahl der Kandidatenzeichenfolge vom Endbenutzer. |
| GL_ID_REVERSECONVERSION | Informationen zur Reversekonvertierung sind verfügbar, indem sie ImmGetGuideLine-aufrufen und GGL_PRIVATE angeben. Die abgerufenen Informationen sind CANDIDATELIST Format. |
Wenn dwIndex- GGL_STRING ist, ist der Rückgabewert die Anzahl der Bytes der Zeichenfolge, die in den Puffer kopiert wurde. Wenn dwBufLen- jedoch 0 ist, ist der Rückgabewert die Puffergröße, die zum Empfangen der Zeichenfolge erforderlich ist, nicht einschließlich des endenden NULL-Zeichens. Wenn dwBufLen "0" ist, ist der Rückgabewert die Größe in Bytes, die nicht das Unicode-Endzeichen null enthält.
Wenn dwIndex- GGL_PRIVATE ist, ist der Rückgabewert die Anzahl der Bytes, die in den Puffer kopiert wurden. Wenn dwIndex- GGL_PRIVATE ist und dwBufLen- 0 ist, ist der Rückgabewert die Puffergröße, die zum Empfangen der Informationen benötigt wird.
Bemerkungen
Anwendungen rufen diese Funktion in der Regel nach erhalt eines IMN_GUIDELINE Befehls auf.
Anmerkung
Der imm.h-Header definiert ImmGetGuideLine als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [Desktop-Apps nur],Ostasiatische Sprachunterstützung installiert. |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | imm.h (include Immdev.h, Windows.h) |
| Library | Imm32.lib |
| DLL- | Imm32.dll |