Share via

IAccPropServices：：ClearProps 方法 (oleacc.h)

  • 项目

服务器使用 ClearProps 将默认值还原到之前批注的可访问元素的属性。

如果服务器知道要清除的对象的 HWND ，则可以使用 IAccPropServices：：ClearHwndProps。

语法

HRESULT ClearProps(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

参数

[in] pIDString

类型： const BYTE*

标识要取消批注的可访问元素。

[in] dwIDStringLen

类型： DWORD

pIDString 的长度。

[in] paProps

类型： const MSAAPROPID*

指定要重置的属性数组。 这些属性将还原为它们在进行批注前显示的默认行为。

[in] cProps

类型： int

paProps 数组的大小。

返回值

类型： HRESULT

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

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

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

注解

有关支持的属性及其预期类型的列表，请参阅支持部分。

清除属性的批注将导致释放任何关联的资源。 如果使用回调属性服务器 (请参阅 SetPropServer) ，则会释放该服务器。

要求

要求 值
最低受支持的客户端 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