RemovePropA, fonction (winuser.h)
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 RemovePropA(
[in] HWND hWnd,
[in] LPCSTR lpString
);
Paramètres
[in] hWnd
Type : HWND
Handle vers 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 16 bits, doit être placée dans le mot de faible ordre de lpString; le mot de haut ordre doit être égal à zéro.
Valeur de retour
Type : HANDLE
La valeur de retour identifie les données spécifiées. Si les données ne sont pas disponibles dans la liste de propriétés spécifiée, 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 peut supprimer uniquement ces propriétés qu’elle a ajoutées. Elle 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 ne peut appeler cette fonction que sur une fenêtre appartenant à un processus de niveau d’intégrité inférieur ou égal. Lorsque l’UIPI bloque les modifications des propriétés, GetLastError retourne 5.
Exemples
Pour obtenir un exemple, consultez Suppression d’une propriété Window.
Note
L’en-tête winuser.h définit RemoveProp 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) |
Voir aussi
conceptuelle
de référence