IAccPropServices::ComposeHwndIdentityString
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.