RemovePropA 函数 (winuser.h)
从指定窗口的属性列表中删除条目。 指定的字符串标识要删除的条目。
语法
HANDLE RemovePropA(
[in] HWND hWnd,
[in] LPCSTR lpString
);
参数
[in] hWnd
类型:HWND
要更改其属性列表的窗口的句柄。
[in] lpString
类型: LPCTSTR
以 null 结尾的字符串或标识字符串的原子。 如果此参数是原子,则必须使用 GlobalAddAtom 函数创建它。 原子(一个 16 位值)必须放在 lpString 的低位字中;高序字必须为零。
返回值
类型: HANDLE
返回值标识指定的数据。 如果在指定的属性列表中找不到数据,则返回值为 NULL。
注解
返回值是传递给 SetProp 的 hData 值;它是应用程序定义的值。 请注意,此函数仅销毁数据和窗口之间的关联。 如果适用,应用程序必须释放与从属性列表中删除的条目关联的数据句柄。 应用程序只能删除已添加的属性。 它不得删除由其他应用程序或系统本身添加的属性。
RemoveProp 函数返回与字符串关联的数据句柄,以便应用程序可以释放与句柄关联的数据。
从 Windows Vista 开始, RemoveProp 受用户界面特权隔离 (UIPI) 的限制。 进程只能在属于较低或相同完整性级别的进程的窗口上调用此函数。 当 UIPI 阻止属性更改时, GetLastError 将返回 5。
示例
有关示例,请参阅 删除窗口属性。
注意
winuser.h 标头将 RemoveProp 定义为别名,该别名根据 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 ( |
另请参阅
概念性
引用
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈