| HANDLE RemoveProp(hwnd, lpsz) | |||||
| HWND hwnd; | /* handle of window | */ | |||
| LPCTSTR lpsz; | /* atom or address of string | */ | |||
This function removes an entry from the property list of the specified window. The character string specified by the lpsz parameter identifies the entry to be removed.
hwnd
Identifies the window whose property list is to be changed.
lpsz
Points to a null-terminated character string or to an atom that identifies a string. If an atom is given, it must have been previously created by means of the AddAtom function. The atom, a 16-bit value, must be placed in the low-order word of lpsz; the high-order word must be zero.
The return value identifies the given string. It is NULL if the string cannot be found in the given property list.
An application must free the data handles associated with entries removed from a property list. The application should only remove those properties which it added to the property list.
The RemoveProp function returns the data handle associated with the string so that the application can free the data associated with the handle.
The RemoveProp function may be used as either a wide-character function (where text arguments must use Unicode) or an ANSI function (where text arguments must use characters from the Windows 3.x character set).
AddAtom, GetProp, SetProp, EnumProps