AoGetStrings()

Get a pointer to the strings exposed by an addon

Synopsis:

#include <aoi.h>

const char* const *AoGetStrings(const AOICtrl_t *ctrl);

Arguments:

ctrl: A pointer to the AOICtrl_t structure of the control from which to get the addon strings.

Library:

libaoi.so

Description:

This function gets a pointer to the addon strings accessible through the given control. An application can call this function to get access to the strings published by the addon through the Strings interface, even after the addon's DLL is unloaded. Then, the application can use AoFindString() to find the settings associated with these strings.

When the application is finished using the strings, it should call AoUngetStrings() to inform the library that it no longer needs this pointer.

Returns:

A constant pointer to an array of immutable copies of the strings exposed by the addon, or NULL if an error occurred.

Classification:

QNX Neutrino