GetPropW, fonction (winuser.h)

Article
11/20/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 des propriétés par un appel précédent à la fonction SetProp.

Syntaxe

HANDLE GetPropW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpString
);

Paramètres

[in] hWnd

Type : HWND

Handle vers la fenêtre dont la liste des propriétés doit être recherchée.

[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 16 bits, doit être placée dans le mot de faible ordre du paramètre lpString ; le mot de haut ordre doit être égal à zéro.

Valeur de retour

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

Note

L’en-tête winuser.h définit GetProp comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll
ensemble d’API	ext-ms-win-ntuser-window-l1-1-0 (introduit dans Windows 8)