1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<HTML> 3<HEAD> 4<META http-equiv="Content-Type" content="text/html; charset=windows-1252"> 5<META http-equiv="Content-Style-Type" content="text/css"> 6<TITLE>SOFinish</TITLE> 7<LINK rel="stylesheet" type="text/css" href="../CSS/rex.css"> 8</HEAD> 9<BODY> 10<H1>SOFinish</H1> 11 12<H2>C Specification</H2> 13<DL> 14 <DD><PRE><CODE>#include <revolution/so.h></CODE></PRE> 15 <DD><PRE><CODE>int SOFinish( void );</CODE></PRE> 16</DL> 17 18<H2>Description</H2> 19<P> 20 Terminates the SO library and returns to the pre-initialization state.<br>If using the SO library again, it is necessary to reinitialize using the <CODE><a href="SOInit.html">SOInit</a></CODE> function. 21</P> 22 23<H2>Arguments</H2> 24<P> 25 None. 26</P> 27 28<h2>Return Values</h2> 29<TABLE border="1" cellpadding="3" cellspacing="0.1"> 30 <TR> 31 <TH>0</TH> 32 <TD> 33 Processing succeeded. 34 </TD> 35 </TR> 36 <TR> 37 <TH>SO_EAGAIN</TH> 38 <TD> 39 Not all memory temporarily allocated by the SO library has been released.<br>There is a chance that an API called from a thread other than the thread calling the <CODE>SOFinish</CODE> function has not terminated. 40 </TD> 41 </TR> 42 <TR> 43 <TH>SO_EALREADY</TH> 44 <TD> 45 Either it has already been terminated with the <CODE>SOFinish</CODE> function, or it has not been initialized with the <CODE><a href="SOInit.html">SOInit</a></CODE> function. 46 </TD> 47 </TR> 48 <TR> 49 <TH>SO_EBUSY</TH> 50 <TD> 51 Because processing that accompanies the state transition of the SO library is in execution, processing cannot be accepted in the current state. 52 </TD> 53 </TR> 54 <TR> 55 <TH>SO_EINPROGRESS</TH> 56 <TD> 57 Because the <CODE><a href="SOStartup.html">SOStartup[Ex]</a></CODE> 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 <CODE><a href="SOCleanup.html">SOCleanup</a></CODE> function. 58 </TD> 59 </TR> 60</TABLE> 61<P style="background-color:ffe8ff;padding-top:4px;padding-bottom:4px;padding-left:4px;padding-right:4px;"> 62 <strong>Note: </strong>Errors may be added as the library is updated. Treat all negative return values as all-purpose errors. 63</P> 64 65<H2>See Also</H2> 66<P> 67 <CODE><a href="SOInit.html">SOInit</a><br> <a href="SOCleanup.html">SOCleanup</a><br></CODE> 68</P> 69 70<H2>Revision History</H2> 71<P> 72 2007/01/31 Initial version.<br> 73</P> 74 75<hr><p>CONFIDENTIAL</p></body> 76</HTML> 77