RemovePropW 函数 (winuser.h)

从指定窗口的属性列表中删除一个条目。 指定的字符串标识要删除的条目。

语法

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

参数

[in] hWnd

类型:HWND

要更改其属性列表的窗口的句柄。

[in] lpString

类型:LPCTSTR

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

返回值

类型:HANDLE

返回值标识指定的数据。 如果在指定的属性列表中找不到数据,则返回值 NULL

言论

返回值是传递给 SetProphData 值;它是应用程序定义的值。 请注意,此函数仅销毁数据与窗口之间的关联。 如果适用,应用程序必须释放与从属性列表中删除的条目关联的数据句柄。 应用程序只能删除已添加的那些属性。 它不得删除其他应用程序或系统本身添加的属性。

RemoveProp 函数返回与字符串关联的数据句柄,以便应用程序可以释放与句柄关联的数据。

从 Windows Vista 开始,RemoveProp 受用户界面特权隔离(UIPI)的限制。 进程只能对属于较小或等于完整性级别的进程的窗口调用此函数。 当 UIPI 阻止属性更改时,GetLastError 将返回 5

例子

有关示例,请参阅 删除 Window 属性

注意

winuser.h 标头将 RemoveProp 定义为一个别名,该别名根据 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 中引入)

另请参阅

AddAtom

概念

GetProp

参考

SetProp

窗口属性