IAccPropServices：：ClearHwndProps 方法 (oleacc.h)

此方法包装 SetPropValue、 SetPropServer 和 ClearProps，并为批注基于 HWND 的可访问元素的调用方提供方便的入口点。

语法

HRESULT ClearHwndProps(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

参数

[in] hwnd

类型： HWND

标识要批注的可访问元素。 这会替换标识字符串。

[in] idObject

类型： DWORD

标识要批注的可访问元素。 这会替换标识字符串。

[in] idChild

类型： DWORD

标识要批注的可访问元素。 这会替换标识字符串。

[in] paProps

类型： const MSAAPROPID*

指定要重置的属性数组。 这些属性将还原为批注前的默认行为。

[in] cProps

类型： int

指定 paProps 数组中的属性数。

返回值

类型： HRESULT

如果成功，则返回S_OK，即使指定的属性从未在可访问对象上批注;清除已清除的属性被视为成功。

如果 不支持 paProps 数组中的任何属性，则返回E_INVALIDARG。

在异常错误条件（例如内存不足）下，可能会返回其他错误代码。

有关返回值的说明，请参阅相应的 SetPropValue、 SetPropServer 或 ClearProps 方法。

注解

通过使用此方法，调用方不必获取标识字符串;它可以直接指定 hwnd、 idObject 和 idChild 参数。

此外， SetHwndPropStr 采用常规 Unicode 字符串作为参数;调用方不需要专门分配 BSTR。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	oleacc.h (包括 OleAcc.h Include Initguid.h first.)
DLL	Oleacc.dll
可再发行组件	具有 SP6 及更高版本和 Windows 98 的 Windows NT 4.0 上的活动辅助功能 2.0 RDK

另请参阅

ClearProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetHwndPropStr