InternalGetWindowText-Funktion (winuser.h)

Artikel
03/04/2024

[Diese Funktion ist nicht für die allgemeine Verwendung vorgesehen. Sie kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein.]

Kopiert den Text der Titelleiste des angegebenen Fensters (sofern vorhanden) in einen Puffer.

Diese Funktion ähnelt der GetWindowText-Funktion . Es ruft jedoch den Fenstertext direkt aus der Fensterstruktur ab, die dem Handle des angegebenen Fensters zugeordnet ist, und stellt den Text dann immer als Unicode-Zeichenfolge bereit. Dies ist im Gegensatz zu GetWindowText , das den Text durch Senden einer WM_GETTEXT Nachricht an das Fenster abruft. Wenn das angegebene Fenster ein Steuerelement ist, wird der Text des Steuerelements abgerufen.

Syntax

int InternalGetWindowText(
  [in]  HWND   hWnd,
  [out] LPWSTR pString,
  [in]  int    cchMaxCount
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster oder Steuerelement, das den Text enthält.

[out] pString

Typ: LPWSTR

Der Puffer, der den Text empfangen soll.

Wenn die Zeichenfolge so lang oder länger als der Puffer ist, wird die Zeichenfolge abgeschnitten und mit einem NULL-Zeichen beendet.

[in] cchMaxCount

Typ: int

Die maximale Anzahl von Zeichen, die in den Puffer kopiert werden sollen, einschließlich des NULL-Zeichens. Wenn der Text diesen Grenzwert überschreitet, wird er abgeschnitten.

Rückgabewert

Typ: int

Wenn die Funktion erfolgreich ist, entspricht der Rückgabewert der Länge in Zeichen der kopierten Zeichenfolge, ohne das abschließende NULL-Zeichen.

Wenn das Fenster keine Titelleiste oder keinen Text enthält, die Titelleiste leer ist oder das Fenster- oder Steuerelementhandle ungültig ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion war erst in den SDK-Headern und -Bibliotheken enthalten, bis Windows XP mit Service Pack 1 (SP1) und Windows Server 2003. Wenn Sie keine Headerdatei und keine Importbibliothek für diese Funktion haben, können Sie die Funktion mit LoadLibrary und GetProcAddress aufrufen.

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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll