ImmGetIMEFileNameA-Funktion (imm.h)

  • Artikel

Ruft den Dateinamen des IME ab, der dem angegebenen Eingabegebietsschema zugeordnet ist.

Syntax

UINT ImmGetIMEFileNameA(
                  HKL   unnamedParam1,
  [out, optional] LPSTR lpszFileName,
  [in]            UINT  uBufLen
);

Parameter

unnamedParam1

[out, optional] lpszFileName

Zeiger auf einen Puffer, in dem die Funktion den Dateinamen abruft. Dieser Parameter enthält NULL , wenn uBufLen auf NULL festgelegt ist.

[in] uBufLen

Größe des Ausgabepuffers in Bytes. Die Anwendung gibt 0 an, wenn die Funktion die Puffergröße zurückgeben soll, die zum Empfangen des Dateinamens erforderlich ist, ohne das beendende NULL-Zeichen. Für Unicode gibt uBufLen die Größe in Unicode-Zeichen an, ohne das endende NULL-Zeichen.

Rückgabewert

Gibt die Anzahl der Bytes im Dateinamen zurück, die in den Ausgabepuffer kopiert wurden. Wenn die Anwendung uBufLen auf 0 festlegt, gibt die Funktion die Größe des Puffers zurück, der für den Dateinamen erforderlich ist. In beiden Fällen ist das beendende NULL-Zeichen nicht enthalten.

Für Unicode gibt die Funktion die Anzahl der Unicode-Zeichen zurück, die in den Ausgabepuffer kopiert wurden, ohne das Unicode-Endzeichen null zu beenden.

Hinweise

In der Registrierung speichert das Betriebssystem den Dateinamen als "IME-Namenswert" im Registrierungsschlüssel HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL.

Hinweis

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

Eingabemethoden-Manager

Funktionen des Eingabemethoden-Managers