Use this method to determine the HMENU, object ID, and child ID for the accessible element identified by the identity string.
HRESULT DecomposeHmenuIdentityString( const BYTE *pIDString, DWORD dwIDStringLen, HMENU *phmenu, DWORD *pidChild );
Type: const BYTE*
Pointer to a buffer containing identity string of an HMENU-based accessible element.
Specifies the length of the identity string specified by pIDString.
Pointer to a buffer that receives the HMENU 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 phmenu or pidChild are not valid, or if the given identity string is not a HMENU-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 an HMENU-based identity string. This method is useful 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|