SOFinish

C Specification

#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 Processing 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: Errors may be added as the library is updated. Treat all negative return values as all-purpose errors.

See Also

SOInit
SOCleanup

Revision History

2007/01/31 Initial version.


CONFIDENTIAL