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。
如果 hwnd、 idObject 或 idChild 无效,则返回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 |