AoUngetStrings()

Updated: April 19, 2023

Inform the library that the caller no longer needs this pointer to the addon strings

Synopsis:

#include <aoi.h>

int32_t AoUngetStrings(const char * const *strings);

Arguments:

strings
A pointer to the addon strings copy that is no longer being used by the caller.

Library:

libaoi.so

Description:

This function informs the library that the caller no longer needs this pointer to the addon strings. The function compares the copy of the strings referenced by the passed-in pointer against the current copy in the control and if they differ, returns an error. This can happen only if your system configuration allows DLLs to be replaced dynamically (i.e., while applications are running). For an explanation of how this can help your application avoid using stale data, see Handling changed addon strings.

If you know that DLLs won't be replaced dynamically, you don't need to examine the return code.

Returns:

0 if the addon strings are up to date, EAGAIN if they're not, which means there's a new version of the DLL and the caller might want to call AoGetStrings() again to see the updated strings.

Classification:

QNX Neutrino