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