IAccIdentity::GetIdentityString 方法 (oleacc.h)
(唯一标识可访问元素的标识字符串) 检索字节字符串。
如果服务器开发人员知道要批注的对象 HWND ,则可以使用以下方法之一,而不是使用此方法并获取标识字符串。
语法
HRESULT GetIdentityString(
[in] DWORD dwIDChild,
[out] BYTE **ppIDString,
[out] DWORD *pdwIDStringLen
);
parameters
[in] dwIDChild
类型: DWORD
指定调用方要标识 的 IAccessible 对象的子对象。
[out] ppIDString
类型: BYTE**
一个变量的地址,该变量用于接收指向被调用方分配的标识字符串的指针。 被调用方使用 CoTaskMemAlloc 分配标识字符串;完成后,调用方必须使用 CoTaskMemFree 释放标识字符串。
[out] pdwIDStringLen
类型: DWORD*
一个变量的地址,该变量用于接收被调用方分配的标识字符串的长度(以字节为单位)。
返回值
类型: HRESULT
返回S_OK,除非在异常错误条件下(例如内存不足)。 如果不支持,在 IAccIdentity 上调用 QueryInterface 应会失败。
注解
返回的字符串应被视为不透明;客户端应仅将其作为一个整体使用,不应尝试对其进行剖析或手动解释。
如果客户端知道或期望字符串基于 HWND,则可以使用 IAccPropServices::D ecomposeHwndIdentityString 尝试分解标识字符串。
要求
最低受支持的客户端 | Windows Vista 或 Windows XP |
最低受支持的服务器 | Windows Server 2003 |
目标平台 | Windows |
标头 | oleacc.h (包括 OleAcc.h Include Initguid.h first.) |
DLL | Oleacc.dll |
可再发行组件 | Windows NT 4.0 SP6 及更高版本以及 Windows 98 上的活动辅助功能 2.0 RDK |