IAccPropServer::GetPropValue 方法 (oleacc.h)

检索可访问元素的属性值。

语法

HRESULT GetPropValue(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [in]  MSAAPROPID idProp,
  [out] VARIANT    *pvarValue,
  [out] BOOL       *pfHasProp
);

参数

[in] pIDString

类型: const BYTE*

包含一个标识所请求的属性的字符串。

[in] dwIDStringLen

类型: DWORD

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

[in] idProp

类型: MSAAPROPID

指定一个 GUID,它指示所需的属性。

[out] pvarValue

类型: VARIANT*

指定重写属性的值。 仅当 pfHasPropTRUE 时,此参数才有效。 如果 pfHasProp 设置为 FALSE,则服务器必须将此设置为 VT_EMPTY。

[out] pfHasProp

类型: BOOL*

指示服务器是否为请求的属性提供值。 如果服务器返回重写属性,则应将其设置为 TRUE ;如果未返回属性 (则服务器应将其设置为 FALSE ,在这种情况下,服务器还应将 pvarValue 设置为 VT_EMPTY) 。

返回值

类型: HRESULT

返回S_OK,但在内存不足等异常错误条件下除外。 如果未重写指定的属性,则 pfHasProp 应设置为 FALSE,pvarValue 应设置为服务器VT_EMPTY。

注解

如果注册了单个回调对象来批注多个可访问元素,则标识字符串可用于确定此请求引用的元素。

如果可访问元素是基于 HWND 的,则可以使用 IAccPropServices::D ecomposeHwndIdentityString 从标识字符串中提取 HWND/idObject/idChild。

如果回调具有要为指定属性返回的值,则应在 pvarValue 中返回它,并将 pfHasProp 设置为 TRUE。 否则,它应将 pvarValue 设置为 VT_EMPTY,并将 pfHasProp 设置为 FALSE。 在后一种情况下,原始 IAccessible 接口指针将用于获取此属性的值。

要求

要求
最低受支持的客户端 Windows Vista 或 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 Windows
标头 oleacc.h (包括 OleAcc.h Include Initguid.h first.)
DLL Oleacc.dll
可再发行组件 具有 SP6 及更高版本和 Windows 98 的 Windows NT 4.0 上的 Active Accessibility 2.0 RDK