IAccPropServices::ComposeHmenuIdentityString method

Callers use ComposeHmenuIdentityString to retrieve an identity string for an HMENU-based accessible element.

Syntax

HRESULT ComposeHmenuIdentityString(
  HMENU hmenu,
  DWORD idChild,
  BYTE  **ppIDString,
  DWORD *pdwIDStringLen
);

Parameters

hmenu

Type: HMENU

Identifies the HMENU-based accessible element.

idChild

Type: DWORD

Specifies the child ID of the accessible element.

ppIDString

Type: BYTE**

Pointer to a buffer that receives the identity string. The callee allocates this buffer using CoTaskMemAlloc. When finished, the caller must free the buffer by calling CoTaskMemFree.

pdwIDStringLen

Type: DWORD*

Pointer to a buffer that receives the length of the identity string.

Return Value

Type: HRESULT

If successful, returns S_OK.

Returns E_INVALIDARG if hmenu or idChild is not valid.

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

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header oleacc.h (include OleAcc.h Include Initguid.h first.)
DLL Oleacc.dll
Redistributable Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98