GetProp

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

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 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 Values

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 SetProp function.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

GlobalAddAtom | SetProp

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.