GetClassNameA-Funktion (winuser.h)

Artikel
03/04/2024

Ruft den Namen der Klasse ab, zu der das angegebene Fenster gehört.

Syntax

int GetClassNameA(
  [in]  HWND  hWnd,
  [out] LPSTR lpClassName,
  [in]  int   nMaxCount
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster und indirekt die Klasse, zu der das Fenster gehört.

[out] lpClassName

Typ: LPTSTR

Die Klassennamenzeichenfolge.

[in] nMaxCount

Typ: int

Die Länge des puffers lpClassName in Zeichen. Der Puffer muss groß genug sein, um das beendende NULL-Zeichen zu enthalten. andernfalls wird die Klassennamenzeichenfolge in nMaxCount-1 Zeichen abgeschnitten.

Rückgabewert

Typ: int

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl der Zeichen, die in den Puffer kopiert wurden, ohne das beendende NULL-Zeichen.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der winuser.h-Header definiert GetClassName 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

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
APIs	ext-ms-win-ntuser-windowclass-l1-1-0 (eingeführt in Windows 8)