Share via


CB_GETLBTEXT message

Obtient une chaîne de la liste d’une zone de liste déroulante.

Paramètres

wParam

Index de base zéro de la chaîne à récupérer.

lParam

Pointeur vers la mémoire tampon qui reçoit la chaîne. La mémoire tampon doit avoir suffisamment d’espace pour la chaîne et un caractère null de fin. Vous pouvez envoyer un message CB_GETLBTEXTLEN avant le message CB_GETLBTEXT pour récupérer la longueur, en TCHAR, de la chaîne. S’il s’agit d’une chaîne ANSI, il s’agit du nombre d’octets, mais s’il s’agit d’une chaîne Unicode, il s’agit du nombre de caractères.

Valeur retournée

La valeur de retour est la longueur de la chaîne, en TCHARs, à l’exclusion du caractère null de fin. Si wParam ne spécifie pas d’index valide, la valeur de retour est CB_ERR.

Notes

Avertissement de sécurité : L’utilisation incorrecte de ce message peut compromettre la sécurité de votre programme. Ce message ne vous permet pas de connaître la taille de la mémoire tampon. Si vous utilisez ce message, appelez d’abord CB_GETLBTEXTLEN pour obtenir le nombre de caractères requis, puis appelez le message pour récupérer la chaîne. Vous devez passer en revue les considérations relatives à la sécurité : Contrôles Microsoft Windows avant de continuer.

Si vous créez la zone de liste déroulante avec un style dessiné par le propriétaire, mais sans le style CBS_HASSTRINGS , la mémoire tampon pointée par lParam reçoit les données associées à l’élément.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2003 [applications de bureau uniquement]
En-tête
Winuser.h (inclure Windows.h)

Voir aussi

CB_GETLBTEXTLEN