IAccPropServices::ComposeHwndIdentityString 方法 (oleacc.h)

调用方使用 ComposeHwndIdentityString 检索标识字符串。

语法

HRESULT ComposeHwndIdentityString(
  [in]  HWND  hwnd,
  [in]  DWORD idObject,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

参数

[in] hwnd

类型: HWND

指定调用方要标识的可访问元素的 HWND

[in] idObject

类型: DWORD

指定可访问元素的对象 ID。

[in] idChild

类型: DWORD

指定可访问元素的子 ID。

[out] ppIDString

类型: BYTE**

指向用于接收标识字符串的缓冲区的指针。 被调用方使用 CoTaskMemAlloc 分配此缓冲区。 完成后,调用方必须通过调用 CoTaskMemFree 释放缓冲区。

[out] pdwIDStringLen

类型: DWORD*

指向用于接收标识字符串长度的缓冲区的指针。

返回值

类型: HRESULT

如果成功,则返回 S_OK。

如果 hwndidObjectidChild 无效,则返回E_INVALIDARG。

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

要求

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