CharLowerA-Funktion (winuser.h)

Artikel
03/06/2024

Konvertiert eine Zeichenfolge oder ein einzelnes Zeichen in Kleinbuchstaben. Wenn der Operand eine Zeichenfolge ist, konvertiert die Funktion die Zeichen an Ort und Stelle.

Syntax

LPSTR CharLowerA(
  [in, out] LPSTR lpsz
);

Parameter

[in, out] lpsz

Typ: LPTSTR

Eine NULL-Zeichenfolge oder gibt ein einzelnes Zeichen an. Wenn das Wort der hohen Ordnung dieses Parameters 0 ist, muss das Wort mit niedriger Ordnung ein einzelnes Zeichen enthalten, um konvertiert zu werden.

Rückgabewert

Typ: LPTSTR

Wenn der Operand eine Zeichenfolge ist, gibt die Funktion einen Zeiger auf die konvertierte Zeichenfolge zurück. Da die Zeichenfolge an Ort und Stelle konvertiert wird, ist der Rückgabewert gleich lpsz.

Wenn der Operand ein einzelnes Zeichen ist, ist der Rückgabewert ein 32-Bit-Wert, dessen Wort in hoher Reihenfolge null ist, und Wort mit niedriger Reihenfolge das konvertierte Zeichen enthält.

Es gibt keinen Hinweis auf Erfolg oder Misserfolg. Fehler sind selten. Es gibt keine erweiterten Fehlerinformationen für diese Funktion. Rufen Sie GetLastError nicht auf.

Hinweise

Beachten Sie, dass CharLower Großbuchstaben I immer Kleinbuchstaben I ("i") zuordnet, auch wenn die aktuelle Sprache Türkisch oder Aserbaidschanisch ist. Wenn Sie eine Funktion benötigen, die in dieser Hinsicht sprachlich sensibel ist, rufen Sie LCMapString auf.

Die Konvertierung in Unicode in der ANSI-Version der Funktion erfolgt in allen Fällen mit dem Standardgebietsschema des Systems.

Hinweis

Der winuser.h-Header definiert CharLower als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll