AoOpenFilespec()

Finds the first control that can open a file in a given mode

Synopsis:

#include <aoi.h>

AOIStream_t *AoOpenFilespec(const char *filename,
                            const char *mode);

Arguments:

filename
The file name you want to open
mode
The mode for opening the file; one of:
rb
Read binary.
wb
Write binary.

Library:

libaoi.so

Description:

This function iterates through all the available addons (addons that have been added using an AoAdd*() function) that export a AOIStreamer interface and returns the AOIStream_t for the first addon that successfully opens the given filespec in the given mode. In this case, the control element of the AOIStream_t structure is filled in with the control, and the control is held. When the stream has been closed, you should release this control.

Returns:

A pointer to an AOIStream_t for the successfully opened stream, orNULL if no streamer addons are found.

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

AOIStream_t, AoRelease()