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 );
Type: const BYTE*
Pointer to a buffer containing identity string of an HWND-based accessible element.
Specifies the length of the identity string specified by pIDString.
Pointer to a buffer that receives the HWND of the accessible element.
Pointer to a buffer that receives the object ID of the accessible element.
Pointer to a buffer that receives the child ID of the accessible element.
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.
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.
|Minimum supported client||Windows XP [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|
|Header||oleacc.h (include OleAcc.h Include Initguid.h first.)|
|Redistributable||Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98|