Callers use ComposeHwndIdentityString to specify the accessible element for which they want an identity string.

HRESULT ComposeHwndIdentityString (
  HWND hwnd,
  DWORD idObject,
  DWORD idChild,
  BYTE** ppIDString,
  DWORD* pdwIDStringLen


hwnd, idObject, idChild
[in] Specifies the accessible element that the caller wants to identify.
ppIDString, pdwIDStringLen
[out] Callee-allocated identity string and its length. Callee allocates this using CoTaskMemAlloc; caller must release using CoTaskMemFree when finished.

Return Values

If successful, returns S_OK.

Returns E_INVALIDARG if hwnd, idObject, or idChild is not valid.

May return other error codes under exceptional error conditions such as low memory.


  Windows NT/2000/XP/Server 2003: Included in Windows XP and Windows Server 2003.
  Windows 95/98/Me: Unsupported.
  Redistributable: Requires Active Accessibility 2.0 RDK on Windows NT 4.0 SP6 and Windows 98.
  Header: Declared in Oleacc.h; include Initguid.h before including Oleacc.h.