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*

指定重写属性的值。 仅当 pfHasProp 为 TRUE 时，此参数才有效。 如果 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