GetClassLongW-Funktion (winuser.h)
Ruft den angegebenen 32-Bit-Wert (DWORD) aus der WNDCLASSEX-Struktur ab, die dem angegebenen Fenster zugeordnet ist.
Syntax
DWORD GetClassLongW(
[in] HWND hWnd,
[in] int nIndex
);
Parameter
[in] hWnd
Typ: HWND
Ein Handle für das Fenster und indirekt die Klasse, zu der das Fenster gehört.
[in] nIndex
Typ: int
Der abzurufende Wert. Um einen Wert aus dem zusätzlichen Klassenspeicher abzurufen, geben Sie den positiven, nullbasierten Byteoffset des abzurufenden Werts an. Gültige Werte liegen im Bereich Null durch die Anzahl der Bytes des zusätzlichen Klassenspeichers, minus vier; Wenn Sie beispielsweise 12 oder mehr Bytes zusätzlichen Klassenspeicher angegeben haben, wäre der Wert 8 ein Index für die dritte ganze Zahl. Geben Sie einen der folgenden Werte an, um einen anderen Wert aus der WNDCLASSEX-Struktur abzurufen.
Wert | Bedeutung |
---|---|
|
Ruft einen ATOM-Wert ab, der die Fensterklasse eindeutig identifiziert. Dies ist das gleiche Atom, das die RegisterClassEx-Funktion zurückgibt. |
|
Ruft die Größe des zusätzlichen Arbeitsspeichers ab, der der Klasse zugeordnet ist. |
|
Ruft die Größe des zusätzlichen Fensterspeichers in Bytes ab, der jedem Fenster in der Klasse zugeordnet ist. Informationen zum Zugriff auf diesen Arbeitsspeicher finden Sie unter GetWindowLong. |
|
Ruft ein Handle für den Hintergrundpinsel ab, der der -Klasse zugeordnet ist. |
|
Ruft ein Handle für den Cursor ab, der der Klasse zugeordnet ist. |
|
Ruft ein Handle zum Symbol ab, das der Klasse zugeordnet ist. |
|
Ruft ein Handle für das kleine Symbol ab, das der Klasse zugeordnet ist. |
|
Ruft ein Handle für das Modul ab, das die -Klasse registriert hat. |
|
Ruft die Adresse der Menünamenzeichenfolge ab. Die Zeichenfolge identifiziert die der -Klasse zugeordnete Menüressource. |
|
Ruft die Fensterklassenstilbits ab. |
|
Ruft die Adresse der Fensterprozedur oder ein Handle ab, das die Adresse der Fensterprozedur darstellt. Sie müssen die CallWindowProc-Funktion verwenden, um die Fensterprozedur aufzurufen. |
Rückgabewert
Art: DWORD
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der angeforderte Wert.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Reservieren Sie zusätzlichen Klassenspeicher, indem Sie einen nonzero-Wert im cbClsExtra-Member der WNDCLASSEX-Struktur angeben, die mit der RegisterClassEx-Funktion verwendet wird.
Hinweis
Der winuser.h-Header definiert GetClassLong 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-1 (eingeführt in Windows 8.1) |
Siehe auch
Konzept
Referenz