IAccPropServices::D ecomposeHwndIdentityString 方法 (oleacc.h)

使用此方法可确定标识字符串标识的可访问元素的 HWND、对象 ID 和子 ID。

语法

HRESULT DecomposeHwndIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HWND       *phwnd,
  [out] DWORD      *pidObject,
  [out] DWORD      *pidChild
);

参数

[in] pIDString

类型: const BYTE*

指向包含基于 HWND 的可访问元素的标识字符串的缓冲区的指针。

[in] dwIDStringLen

类型: DWORD

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

[out] phwnd

类型: HWND*

指向接收可访问元素的 HWND 的缓冲区的指针。

[out] pidObject

类型: DWORD*

指向某个缓冲区的指针,该缓冲区接收可访问元素的对象 ID。

[out] pidChild

类型: DWORD*

指向某个缓冲区的指针,该缓冲区接收可访问元素的子 ID。

返回值

类型: HRESULT

如果成功,则返回 S_OK。

如果 phwndpidObjectpidChild 无效,或者给定标识字符串不是基于 HWND 的标识字符串,则返回E_INVALIDARG。

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

注解

仅当提供的标识字符串是基于 HWND 的标识字符串时,此方法才会成功。 此方法在已注册到 ANNO_CONTAINER 范围的 IAccPropServer 回调服务器中使用时非常有用,因为它允许服务器从给定的标识字符串中确定客户端为其调用服务器的 idChild) (子元素。

要求

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