IAccPropServices：：SetPropServer 方法 (oleacc.h)

服务器使用 SetPropServer 指定要用于批注可访问元素的属性数组的回调对象。 还可以指定是将此批注应用于此可访问元素，还是应用于元素及其子元素。 此方法用于 服务器批注。

如果服务器开发人员知道要批注的可访问元素的 HWND ，则可以使用 IAccPropServices：：SetHwndPropServer。

语法

HRESULT SetPropServer(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

parameters

[in] pIDString

类型： const BYTE*

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

[in] dwIDStringLen

类型： DWORD

指定由 pIDString 参数标识的字符串的长度。

[in] paProps

类型： const MSAAPROPID*

指定要由指定回调对象处理的属性数组。

[in] cProps

类型： int

指定要由指定回调对象处理的属性数组。

[in] pServer

类型： IAccPropServer*

指定将在客户端请求一个已重写属性时调用的回调对象。

[in] annoScope

类型： AnnoScope

可以为 ANNO_THIS，指示批注仅影响所指示的可访问元素；也可以为 ANNO_CONTAINER，指示批注应用于元素及其直接子元素。

返回值

类型： HRESULT

如果成功，则返回 S_OK。

如果 paProps 数组中的任何属性都不支持属性、标识字符串无效，或者 annoScope 不是ANNO_THIS或ANNO_CONTAINER之一，则返回E_INVALIDARG。

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

注解

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

批注运行时将使用 AddRef 适当地递增 pServer 回调对象的引用计数器。 调用方在调用此方法后可以自由 释放 它。 批注运行时将自动释放回调对象后，不再使用批注的可访问元素。

要求

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