The mi_lo_stat() function is the constructor
for the LO-status structure. The third argument to the mi_lo_stat() function
indicates whether to create a LO-status structure:
When you pass a NULL-valued pointer, the mi_lo_stat() function
allocates a new LO-status structure.
Server only: This LO-status structure has the current memory duration.
When you pass a pointer that does not point to NULL, the mi_lo_stat() function
assumes that the pointer references an existing LO-status structure
that a previous call to mi_lo_stat() has allocated.
An
LO-status pointer that does not point to NULL allows a DataBlade®
API module
to reuse an LO-status structure.
For example, the following code fragment uses the mi_lo_stat() function
to allocate memory for the LO-status structure only when the first_time flag
is true. Figure 1: Sample
mi_lo_stat() call
MI_CONNECTION *conn;
MI_LO_HANDLE *LO_hdl;
MI_LO_STAT *LO_stat;
MI_LO_FD LO_fd;
mi_integer first_time;
...
LO_fd = mi_lo_open(conn, LO_hdl, MI_LO_RDONLY);
if ( first_time )
{
...
LO_stat = NULL; /* tell interface to allocate memory */
first_time = 0; /* set "first_time" flag to false */
...
}
err = mi_lo_stat(conn, LO_fd, &LO_stat);