Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

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