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

See also:

AOIStream_t, AoRelease()