InternalGetWindowText, fonction (winuser.h)

Article
08/27/2023

[Cette fonction n’est pas destinée à une utilisation générale. Il peut être modifié ou indisponible dans les versions ultérieures de Windows.]

Copie le texte de la barre de titre de la fenêtre spécifiée (le cas échéant) dans une mémoire tampon.

Cette fonction est similaire à la fonction GetWindowText . Toutefois, il obtient le texte de la fenêtre directement à partir de la structure de fenêtre associée au handle de la fenêtre spécifiée, puis fournit toujours le texte sous forme de chaîne Unicode. Cela est différent de GetWindowText qui obtient le texte en envoyant à la fenêtre un message WM_GETTEXT . Si la fenêtre spécifiée est un contrôle, le texte du contrôle est obtenu.

Syntaxe

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

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre ou du contrôle contenant le texte.

[out] pString

Type : LPWSTR

Mémoire tampon qui doit recevoir le texte.

Si la chaîne est aussi longue ou plus longue que la mémoire tampon, la chaîne est tronquée et terminée par un caractère null.

[in] cchMaxCount

Type : int

Nombre maximal de caractères à copier dans la mémoire tampon, y compris le caractère null. Si le texte dépasse cette limite, il est tronqué.

Valeur retournée

Type : int

Si la fonction réussit, la valeur de retour est la longueur, en caractères, de la chaîne copiée, sans inclure le caractère null de fin.

Si la fenêtre n’a pas de barre de titre ou de texte, si la barre de titre est vide ou si la fenêtre ou le handle de contrôle n’est pas valide, la valeur renvoyée est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction n’a pas été incluse dans les bibliothèques et en-têtes du KIT de développement logiciel (SDK) avant Windows XP avec Service Pack 1 (SP1) et Windows Server 2003. Si vous n’avez pas de fichier d’en-tête et de bibliothèque d’importation pour cette fonction, vous pouvez appeler la fonction en utilisant LoadLibrary et GetProcAddress.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll