ImmGetIMEFileNameW-Funktion (imm.h)
Ruft den Dateinamen des IME ab, der dem angegebenen Eingabegebietsschema zugeordnet ist.
Syntax
UINT ImmGetIMEFileNameW(
HKL unnamedParam1,
[out, optional] LPWSTR 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 Byte. Die Anwendung gibt 0 an, wenn die Funktion die Puffergröße zurückgeben soll, die zum Empfangen des Dateinamens erforderlich ist, ohne das abschließende NULL-Zeichen. Für Unicode gibt uBufLen die Größe in Unicode-Zeichen an, ohne das abschließende 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 abschließende 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 einzuschließt.
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 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
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps],Unterstützung für ostasiatische Sprache 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 |