GweBypassCoredllThunk_t::RemoveProp_I (Windows Embedded CE 6.0)

1/6/2010

This method removes an entry identified by a specified character string from the property list of a specified window.

Syntax

static HANDLE RemoveProp_I(
  HWND hWnd,
  LPCTSTR lpString
);

Parameters

• hWnd
  [in] Handle to the window for which you want to change the property list.

• lpString
  [in] Pointer to a null-terminated character string that identifies the property that you want to remove, or an atom that identifies the string. If this parameter is an atom, the application must create the atom by using the GlobalAddAtom function. The application must place the atom, a 16-bit value, in the low-order word of the lpString parameter; the high-order word of lpString must then be zero.

Return Value

The data handle associated with the specified string indicates that the property list contained the string, and that GweBypassCoredllThunk_t::RemoveProp_I removed the association between the property and the window. NULL indicates that the specified string was not found in the specified property list.

Remarks

This method is an internal version of the RemoveProp function.

The return value is an application-defined value that the application passed to the GweBypassCoredllThunk_t::SetProp_I method in the hData parameter. GweBypassCoredllThunk_t::RemoveProp_I only destroys the association between the data and the window. GweBypassCoredllThunk_t::RemoveProp_I returns the data handle associated with the string so that the application can free the data associated with the handle. The application is responsible for freeing these data handles. The application can remove only those properties that the application has added itself. The application should not remove properties that other applications or the operating system added.

Requirements

See Also

Reference

GweBypassCoredllThunk_t
GlobalAddAtom
RemoveProp
GweBypassCoredllThunk_t::GetProp_I
GweBypassCoredllThunk_t::SetProp_I