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