RemovePropW, fonction (winuser.h)

Article
08/28/2023

Supprime une entrée de la liste de propriétés de la fenêtre spécifiée. La chaîne de caractères spécifiée identifie l’entrée à supprimer.

Syntaxe

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

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre dont la liste des propriétés doit être modifiée.

[in] lpString

Type : LPCTSTR

Chaîne de caractères terminée par null ou 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 de lpString ; le mot d’ordre élevé doit être égal à zéro.

Valeur retournée

Type : HANDLE

La valeur de retour identifie les données spécifiées. Si les données sont introuvables dans la liste de propriétés spécifiées, la valeur de retour est NULL.

Remarques

La valeur de retour est la valeur hData qui a été passée à SetProp ; il s’agit d’une valeur définie par l’application. Notez que cette fonction détruit uniquement l’association entre les données et la fenêtre. Si nécessaire, l’application doit libérer les handles de données associés aux entrées supprimées d’une liste de propriétés. L’application ne peut supprimer que les propriétés qu’elle a ajoutées. Il ne doit pas supprimer les propriétés ajoutées par d’autres applications ou par le système lui-même.

La fonction RemoveProp retourne le handle de données associé à la chaîne afin que l’application puisse libérer les données associées au handle.

À compter de Windows Vista, RemoveProp est soumis aux restrictions de l’isolation des privilèges d’interface utilisateur (UIPI). Un processus peut uniquement appeler cette fonction sur une fenêtre appartenant à un processus de niveau d’intégrité inférieur ou égal. Lorsque UIPI bloque les modifications de propriété, GetLastError retourne la valeur 5.

Exemples

Pour obtenir un exemple, consultez Suppression d’une propriété de fenêtre.

Notes

L’en-tête winuser.h définit RemoveProp comme un 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.

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)