SOFinish

Syntax

#include <revolution/so.h>
int SOFinish( void );

Description

Terminates the SO library and returns to the pre-initialization state.
If using the SO library again, it is necessary to reinitialize using the SOInit function.

Arguments

None.

Return Values

0 Process succeeded.
SO_EAGAIN Not all memory temporarily allocated by the SO library has been released.
There is a chance that an API called from a thread other than the thread calling the SOFinish function has not terminated.
SO_EALREADY Either it has already been terminated with the SOFinish function, or it has not been initialized with the SOInit function.
SO_EBUSY Because processing that accompanies the state transition of the SO library is in execution, processing cannot be accepted in the current state.
SO_EINPROGRESS Because the SOStartup[Ex] function has moved it into a state in which communication is possible, it cannot be terminated. You must call after moving to the initialized state due to the SOCleanup function.

Note: Error codes other than those described above might be returned following subsequent library or console firmware updates. To deal with unexpected errors during development, treat all negative return values other than those described above as fatal errors, and either halt program execution or perform similar error handling.

See Also

SOInit
SOCleanup

Revision History

2008/05/19 Revised notes for error codes.
2007/01/31 Initial version.


CONFIDENTIAL