AoGetAOInterface()

Get an interface by only its index from a control

Synopsis:

#include <aoi.h>

AOInterface_t *AoGetAOInterface(const AOICtrl_t *ctrl,
                                const int32_t nth);

Arguments:

ctrl
A pointer to an AOICtrl_t handle to the control containing the interface you want to get.
nth
The zero-based index of the interface to get.

Library:

libaoi.so

Description:

This function searches for the nth interface (in a zero-based index) in the given control. It is similar to calling AoGetInterface() with a name argument of NULL, meaning that the interface is looked up by only its index, but a pointer to the interface structure is returned instead of the interface itself.

Before calling this function, the caller must hold the control using AoHold().

Returns:

A pointer to an AOInterface_t structure representing the nth interface in the control, or NULL if the index is out of range.

Classification:

QNX Neutrino