Obtain a valid LO-status structure
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.