RemoveProp

Syntax

HANDLE RemoveProp(hWnd,lpString)

This function removes an entry from the property list of the specified window. The character string specified by the lpString parameter identifies the entry to be removed.

The RemoveProp function returns the data handle associated with the string so that the application can free the data associated with the handle.

Parameter Type/Description  

hWnd HWND Identifies the window whose property list is to be changed.  
lpString LPSTR 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 lpString; the high-order word must be zero.  

Return Value

The return value identifies the given string. It is NULL if the string cannot be found in the given property list.

Comments

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.