Edit

Share via

ObjectFromLresult function (oleacc.h)

  • Article

Retrieves a requested interface pointer for an accessible object based on a previously generated object reference.

This function is designed for internal use by Microsoft Active Accessibility and is documented for informational purposes only. Neither clients nor servers should call this function.

Syntax

HRESULT ObjectFromLresult(
  [in]  LRESULT lResult,
  [in]  REFIID  riid,
  [in]  WPARAM  wParam,
  [out] void    **ppvObject
);

Parameters

[in] lResult

Type: LRESULT

A 32-bit value returned by a previous successful call to the LresultFromObject function.

[in] riid

Type: REFIID

Reference identifier of the interface to be retrieved. This is IID_IAccessible.

[in] wParam

Type: WPARAM

Value sent by the associated WM_GETOBJECT message in its wParam parameter.

[out] ppvObject

Type: void**

Receives the address of the IAccessible interface on the object that corresponds to the WM_GETOBJECT message.

Return value

Type: STDAPI

If successful, returns S_OK.

If not successful, returns one of the following standard COM error codes.

Return code Description
E_INVALIDARG
 One or more arguments are not valid. This occurs when the lResult parameter specified is not a value obtained by a call to LresultFromObject, or when lResult is a value used on a previous call to ObjectFromLresult.
E_NOINTERFACE
 The object specified in the ppvObject parameter does not support the interface specified by the riid parameter.
E_OUTOFMEMORY
 Insufficient memory to store the object reference.
E_UNEXPECTED
 An unexpected error occurred.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header oleacc.h
Library Oleacc.lib
DLL Oleacc.dll
Redistributable Active Accessibility 2.0 RDK on Windows NT 4.0 with SP6 and later and Windows 98

See also

WM_GETOBJECT