AoAddDll()

Updated: October 26, 2022

Add the interfaces in a DLL to the global list of interfaces and apply the given configuration settings

Synopsis:

#include <aoi.h>

const AOICtrl_t *AoAddDll(const char *dll, 
                          const char * const configs[],
                          AOError_t *err);

Arguments:

dll
The path and filename of the DLL containing the interfaces that you want to add.
configs
An array of immutable strings containing configuration settings to apply to the interfaces.
err
A pointer to an AOError_t structure for storing error information (if necessary).

Library:

libaoi.so

Description:

This function is similar to AoAdd() but in addition to adding the interfaces in the specified DLL to the global list, it configures these interfaces based on the given array of strings (configs). If an improper configuration is specified in these strings, the function fails and writes error information in the structure referenced by err.

When successful, the function returns a control handle for the registered interfaces. With this handle, you can access the interfaces with AoGetInterface(), or search for a specific set of interfaces with an AoFind*() function.

Returns:

A pointer to the control handle (of type AOICtrl_t) for the added interfaces, or NULL if an error occurred.

Classification:

QNX Neutrino