ImmGetConversionListA-Funktion (imm.h)

Artikel
11/20/2024

Ruft die Konvertierungsergebnisliste von Zeichen oder Wörtern ab, ohne IME-bezogene Nachrichten zu generieren.

Syntax

DWORD ImmGetConversionListA(
        HKL             unnamedParam1,
        HIMC            unnamedParam2,
  [in]  LPCSTR          lpSrc,
  [out] LPCANDIDATELIST lpDst,
  [in]  DWORD           dwBufLen,
  [in]  UINT            uFlag
);

Parameter

unnamedParam1

unnamedParam2

[in] lpSrc

Zeiger auf eine mit Null beendete Zeichenfolge, die die Quelle der Liste angibt.

[out] lpDst

Zeigen Sie auf eine CANDIDATELIST- Struktur, in der die Funktion die Liste abruft.

[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 für die vollständige Konvertierungsergebnisliste erforderlich ist.

[in] uFlag

Aktionsflagge. Dieser Parameter kann einen der folgenden Werte aufweisen.

Wert	Bedeutung
GCL_CONVERSION	Quellzeichenfolge ist die Lesezeichenfolge. Die Funktion kopiert die Ergebniszeichenfolge in den Zielpuffer.
GCL_REVERSECONVERSION	Quellzeichenfolge ist die Ergebniszeichenfolge. Die Funktion kopiert die Lesezeichenfolge in den Zielpuffer.
GCL_REVERSE_LENGTH	Quellzeichenfolge ist die Ergebniszeichenfolge. Die Funktion gibt die Größe der Lesezeichenfolge in Bytes zurück, die erstellt wird, wenn GCL_REVERSECONVERSION angegeben ist.

Rückgabewert

Gibt die Anzahl der in den Ausgabepuffer kopierten Bytes zurück. Wenn die Anwendung den dwBufLen Parameter auf 0 festlegt, gibt die Funktion die Größe des erforderlichen Ausgabepuffers in Bytes zurück.

Bemerkungen

Anmerkung

Der imm.h-Header definiert ImmGetConversionList 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

Siehe auch

CANDIDATELIST-

Eingabemethoden-Manager

Funktionen des Eingabemethoden-Managers

Freigeben über