IAccessible::get_accParent

[This is preliminary documentation and subject to change.]

Retrieves the IDispatch interface of the current object's parent.

HRESULT get_accParent(
  IDispatch** ppdispParent
);
 

Parameters

ppdispParent

[out, retval] Address of a variable that will contain the parent object's IDispatch interface. The variable will be set to NULL if no parent exists or the child cannot access its parent.

Return Values

Returns S_OK if successful or a standard COM error code otherwise.

Note The IDispatch interface returned must be released when the client is finished using it. This can be done by calling the Release() member. Failure to do so will keep the object in memory, causing memory leaks.

Note to implementers This method must not fail if no parent object exists. Instead, return S_FALSE and set the variable at ppdispParent to NULL.

See Also

IAccessible::get_accChild, Object Navigation, IDispatch Interface