GetPropW 函数 (winuser.h)

从指定窗口的属性列表中检索数据句柄。 字符串标识要检索的句柄。 该字符串和句柄必须由对 SetProp 函数的上一次调用添加到属性列表中。

语法

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

参数

[in] hWnd

类型:HWND

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

[in] lpString

类型:LPCTSTR

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

返回值

类型:HANDLE

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

言论

注意

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

要求

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

另请参阅

概念

GlobalAddAtom

参考

SetProp

窗口属性

ITaskbarList2::MarkFullscreenWindow