[This is preliminary documentation and subject to change.]
This table lists the values that all the IAccessible interface methods can return.
DISP_E_MEMBERNOTFOUND | |
The current object does not support the requested property or action. For example, a push button returns this value if you request its Value property, since it has none. | |
E_INVALIDARG | |
One or more arguments was invalid. This error can occur when the caller attempts to identify a child object using an identifier that the server doesn't support (child ID when the server uses strings, or vice versa). This error can also result when a client attempts to identify a child object within an object that has no children. | |
E_FAIL | |
An unknown or generic error occurred. | |
E_NOTIMPL | |
The method is not implemented. This value can occur when a client calls a method that isn't yet supported in that operating system. | |
E_OUTOFMEMORY | |
The method was unable to allocate memory required to complete an operation crucial to its success. | |
S_FALSE | |
The method succeeded in part. This can happen when the method itself succeeded, but the requested information isn't available. For example, this return value will result if you call the IAccessible::accHitTest method to retrieve a child object at a given point and the specified point is not within the parent object. | |
S_OK | |
The method succeeded. |
Like all COM error codes, you can use the SUCCEEDED and FAILED macros to test the HRESULT return values that Active Accessibility API elements return. Although these macros provide a simple way to test for a method's overall success or failure, always check the output parameters that you pass with a method call. For example, when one of a method's output parameters is a pointer, you can get a successful return value (such as S_FALSE) but still receive a NULL pointer in an output parameter.