Export (0) Print
Expand All

IAccPropServices::ComposeHwndIdentityString method

Callers use ComposeHwndIdentityString to retrieve an identity string.

Syntax


HRESULT ComposeHwndIdentityString(
  [in]   HWND hwnd,
  [in]   DWORD idObject,
  [in]   DWORD idChild,
  [out]  BYTE **ppIDString,
  [out]  DWORD *pdwIDStringLen
);

Parameters

hwnd [in]

Type: HWND

Specifies the HWND of the accessible element that the caller wants to identify.

idObject [in]

Type: DWORD

Specifies the object ID of the accessible element.

idChild [in]

Type: DWORD

Specifies the child ID of the accessible element.

ppIDString [out]

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 [out]

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 hwnd, idObject, 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]

Redistributable

Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98

Header

Oleacc.h (include OleAcc.h Include Initguid.h first.)

DLL

Oleacc.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft