IAccessible::get_accChildCount method (oleacc.h)

The IAccessible::get_accChildCount method retrieves the number of children that belong to this object. All objects must support this property.


HRESULT get_accChildCount(
  [out, retval] long *pcountChildren


[out, retval] pcountChildren

Type: long*

Address of a variable that receives the number of children that belong to this object. The children are accessible objects or child elements. If the object has no children, this value is zero.

Return value


If successful, returns S_OK.

If not successful, returns a standard COM error code. Servers return these values, but clients must always check output parameters to ensure that they contain valid values. For more information, see Checking IAccessible Return Values.


The number of children in an object can change. An application tracks the changes to the child count by watching for EVENT_OBJECT_CREATE and EVENT_OBJECT_DESTROY events generated by this object.

Note to server developers:  If the object does not have any children, return S_OK and set pcountChildren to zero.


Requirement Value
Minimum supported client Windows 2000 Professional [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 1.3 RDK on Windows NT 4.0 with SP6 and later and Windows 95

See also