ImmGetIMEFileNameA-Funktion (imm.h)
Ruft den Dateinamen des IME ab, das dem angegebenen Eingabegebietsschema zugeordnet ist.
Syntax
UINT ImmGetIMEFileNameA(
HKL unnamedParam1,
[out, optional] LPSTR lpszFileName,
[in] UINT uBufLen
);
Parameter
unnamedParam1
[out, optional] lpszFileName
Zeigen Sie 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ückgibt, die zum Empfangen des Dateinamens erforderlich ist, nicht einschließlich des endenden NULL-Zeichens. Für Unicode gibt uBufLen- die Größe in Unicode-Zeichen an, nicht einschließlich des endenden NULL-Zeichens.
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 für den Dateinamen erforderlichen Puffers zurück. In beiden Fällen ist das endende Nullzeichen nicht enthalten.
Bei Unicode gibt die Funktion die Anzahl der in den Ausgabepuffer kopierten Unicode-Zeichen zurück, nicht einschließlich des Unicode-Endzeichens null.
Bemerkungen
In der Registrierung speichert das Betriebssystem den Dateinamen als "IME-Namenswert" im Registrierungsschlüssel HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Keyboard Layouts\HKL.
Anmerkung
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
| 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 |