Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function retrieves a data handle identified by a specified character string from the property list of a specified window.

Syntax

HANDLE GetProp(
  HWND 
hWnd,
  LPCTSTR 
lpString
);

Parameters

hWnd

[in] Handle to the window for which you want to retrieve a data handle from the property list.

lpString

[in] Pointer to a null-terminated character string that identifies the data handle, or an atom that identifies the string. If this parameter is an atom, the application must create the atom by using the GlobalAddAtomfunction. The application must place the atom, a 16-bit value, in the low-order word of the lpStringparameter; the high-order word of lpStringmust then be zero.

Return Value

The data handle associated with the specified string indicates that the property list contains the string. NULL indicates that the property list does not contain the string.

Remarks

The application must add the string and handle to the property list by previously calling the SetPropfunction.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also