GetPropW 函数 (winuser.h)

从指定窗口的属性列表中检索数据句柄。 字符串标识要检索的句柄。 字符串和句柄必须已通过对 SetProp 函数的先前调用添加到属性列表。

语法

HANDLE GetPropW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpString
);

参数

[in] hWnd

类型:HWND

要搜索其属性列表的窗口的句柄。

[in] lpString

类型: LPCTSTR

标识字符串的原子。 如果此参数是原子,则必须已使用 GlobalAddAtom 函数创建。 原子(一个 16 位值)必须放置在 lpString 参数的低序字中;高序字必须为零。

返回值

类型: HANDLE

如果属性列表包含字符串,则返回值为关联的数据句柄。 否则,返回值为 NULL

注解

注意

winuser.h 标头将 GetProp 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 windows 8 中引入的 ext-ms-win-ntuser-window-l1-1-0 ()

请参阅

概念性

GlobalAddAtom

引用

SetProp

窗口属性

ITaskbarList2::MarkFullscreenWindow