AoGetInterface()

Retrieve an interface from a control

Synopsis:

#include <aoi.h>

void *AoGetInterface(const AOICtrl_t *control,
                     const char *name,
                     const int32_t version,
                     const int32_t nth);

Arguments:

control

A pointer to an AOICtrl_t structure for the control that contains the interface you want to retrieve.

name

Optional. The name of the interface you want to retrieve, or NULL if you don't want to find an interface using the “Name” interface.

version

Optional. The minimum version of the interface you want to retrieve. This argument is used only if name is specified.

nth

The instance number of the interface you want to retrieve.

Library:

libaoi.so

Description:

This function searches for the nth (starting at 0) interface with the given name and minimum version number in the given control, if specified.

You must hold the control (using AoHold()) before calling this function.

Returns:

The nth interface control, if found, or NULL if no interface control is found.

Classification:

QNX Neutrino

See also:

AOICtrl_t, AoHold(), AoIterate(), AoIterateHoldGet()