IAccPropServices::ComposeHwndIdentityString

  • Article

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);

Parameters

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

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.