GetPropA, fonction (winuser.h)

Article
03/13/2024

Récupère un handle de données à partir de la liste de propriétés de la fenêtre spécifiée. La chaîne de caractères identifie le handle à récupérer. La chaîne et le handle doivent avoir été ajoutés à la liste de propriétés par un appel précédent à la fonction SetProp .

Syntaxe

HANDLE GetPropA(
  [in] HWND   hWnd,
  [in] LPCSTR lpString
);

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre dont la liste de propriétés doit faire l’objet d’une recherche.

[in] lpString

Type : LPCTSTR

Atome qui identifie une chaîne. Si ce paramètre est un atome, il doit avoir été créé à l’aide de la fonction GlobalAddAtom . L’atome, une valeur de 16 bits, doit être placé dans le mot d’ordre inférieur du paramètre lpString ; le mot d’ordre supérieur doit être égal à zéro.

Valeur retournée

Type : HANDLE

Si la liste de propriétés contient la chaîne, la valeur de retour est le handle de données associé. Sinon, la valeur de retour est NULL.

Remarques

Notes

L’en-tête winuser.h définit GetProp en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-0 (introduit dans Windows 8)