IAccPropServices::DecomposeHwndIdentityString

Use this method to determine the Hwnd, object id, and child id for the accessible element identified by the identity string.

HRESULT DecomposeHwndIdentityString (
  const BYTE* pIDString,  DWORD dwIDStringLen,  HWND* phwnd,  DWORD* pidObject,  DWORD* pidChild);

Parameters

  • pIDString, dwIDStringLen
    [in] Specifies the identity string of a Hwnd-based accessible element.
  • phwnd, pidObject, pidChild
    [out] Returns the HWND, idObject, and idChild parameters corresponding to the accessible element referenced by the given identity string.

Return Values

If successful, returns S_OK.

Returns E_INVALIDARG if phwnd, pidObject, or pidChild are not valid, or if the given identity string is not a Hwnd-based identity string.

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

Remarks

This method succeeds only if the provided identity string is a Hwnd-based identity string. This method is useful when used in an IAccPropServer callback server that was registered with ANNO_CONTAINER scope because it allows the server to determine, from the given identity string, the child element (idChild) for which the client is calling the server.

Requirements

**  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.