Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/addon/ao/aofindname.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/addon/ao/aofindname.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/addon/ao/aofindname.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/addon/ao/aofindname.html on line 8

AoFindName()

Find a control by its “Name” interface

Synopsis:

#include <aoi.h>

const AOICtrl_t *AoFindName(const char *name,
                            const char *interface,
                            int32_t version);

Arguments:

name
The name of the control you want to find, set in a control's “Name” interface.
interface
The interface contained in the control you want to find.
version
The version of the interface in the control you want to find.

Library:

libaoi.so

Description:

This function finds a control with the name, that also has the interface and version specified. Controls are named if they have a string interface called “Name” declared in their interfaces list.

Returns:

A pointer to an AOICtrl_t structure for a control with a matched name, if one exists, and NULL if no control is found.

Examples:

Here's an example of a “Name” interface declaration:

AOInterface_t pnm_idecoder_interface[] =
{
        {"Name",0,"pnm_idecoder"},
        {"Description",0,"PNM Image Reader"},
        ... (other interfaces)
        {0,0,0},
};

If the above interfaces were already added to the list of available interfaces, and you wanted to find the AOI control for the pnm_idecoder interface, you would write code like:

 AOICtrl_t *ctrl;

 ctrl=AoFindName("pnm_idecoder",NULL,0);

 // now we can use the ctrl to find specific interfaces, etc.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

AoFindExt(), AoFindMime(), AoFindFormats(), AoFindStreams(), AOICtrl_t


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/addon/ao/aofindname.html on line 135

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/addon/ao/aofindname.html on line 135