ImmGetConversionListA-Funktion (imm.h)

  • Artikel

Ruft die Konvertierungsergebnisliste mit 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 NULL-Zeichenfolge, die die Quelle der Liste angibt.

[out] lpDst

Zeiger 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ückgeben soll, die für die vollständige Konvertierungsergebnisliste erforderlich ist.

[in] uFlag

Aktionsflag. 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 wird.

Rückgabewert

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

Hinweise

Hinweis

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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps],Ostasiatische Sprachunterstützung installiert.
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile imm.h (include Immdev.h, Windows.h)
Bibliothek Imm32.lib
DLL Imm32.dll

Weitere Informationen

KANDIDATENLISTE

Eingabemethoden-Manager

Funktionen des Eingabemethoden-Managers