AoIterate()

Find a list of controls for an interface name and version

Synopsis:

#include <aoi.h>

const AOICtrl_t *AoIterate(const char *name,
                           const int32_t version,
                           int32_t * const cookie);

Arguments:

name

The name of the interface that the returned control contains.

version

The minimum version of the interface that the returned control contains.

cookie

An opaque variable used to iterate through available AOI controls. Set the value to 0 on the first call to this function.

Library:

libaoi.so

Description:

This function iterates through all available AOI controls, returning each AOI control that has the given interface name and minimum version number version. The first time you call this function, you should set the value in *cookie to 0. You can keep calling this function until it returns NULL. If name is NULL, AoIterate() iterates through all the controls in the global list.

Returns:

A a pointer to an AOIControl_t structure for the control containing an interface that matches name and version. Subsequent calls return the next matched control, until there are no more matches. When there are no more matches, the function returns NULL.

Classification:

QNX Neutrino

See also:

AOICtrl_t, AoGetInterface(), AoIterateHoldGet(), AoHold()