This wiki is out of date, use the continuation of this wiki instead

From FenixWiki

Revision as of 23:00, 15 April 2007 (edit) Sandman (Talk | contribs) m ← Previous diff		Revision as of 15:10, 24 July 2007 (edit) (undo) Sandman (Talk | contribs) m Next diff →
Line 2:		Line 2:
	[[Category:networkdllfunctions]]		[[Category:networkdllfunctions]]
-	==Definition==	+	[[networkdllfunctions|'''Up to Network.DLL Functions''']]
		+	----
-	'''INT''' NET_Listen ( '''WORD''' port , ['''BYTE''' consolereports] )
-	Listens on the specified port. The connections accepted will inherit certain variables from the listenport they were connected on. These variables are consolereports and separator.<br />	+	==Definition==
		+	'''INT''' NET_Listen ( <'''WORD''' port> , [<'''BYTE''' consolereports>] )
		+	Opens a listenconnection on a certain port. The connections accepted will inherit certain variables from the listenport they were connected on. These variables are consolereports and separator.
	== Parameters ==		== Parameters ==
-
	{|		{|
	| '''WORD''' port || The port on which to listen.		| '''WORD''' port || The port on which to listen.
	|-		|-
-	| ['''BYTE''' consolereports] || Specifies if there will be console reports for this connection (like messages) (true/false)	+	| ['''BYTE''' consolereports] || [[true]]/[[false]]: specifies whether there will be console reports for this connection (like messages).
	|}		|}
-
	== Returns ==		== Returns ==
-		+	INT : Connection identifier.
-	INT : [[NET_ERRORCODES|Network.DLL Errorcode]]	+
	{|		{|
-	| NET_ERROR_INVALIDSOCKETSET || The socketset is invalid.	+	| NET_ERROR_INVALIDSOCKETSET || - - The socketset is invalid.
	|-		|-
-	| NET_ERROR_SOCKETSETINACTIVE || The socketset is inactive.	+	| NET_ERROR_SOCKETSETINACTIVE || - The socketset is inactive.
	|-		|-
-	| NET_ERROR_INVALIDPORTNUMBER || The portnumber is invalid (<0 or >65535).	+	| NET_ERROR_INVALIDPORTNUMBER || - The portnumber is invalid (<0 or >65535).
	|-		|-
-	| NET_ERROR_INVALIDTYPE || The type specified is invalid.	+	| NET_ERROR_INVALIDTYPE || - The type specified is invalid.
	|-		|-
-	| NET_ERROR_TOOMANYCONNS || There are too many connections	+	| NET_ERROR_TOOMANYCONNS || - There are too many connections
	|-		|-
-	| NET_ERROR_RESOLVINGHOST || Could not resolve host.	+	| NET_ERROR_RESOLVINGHOST || - Could not resolve host.
	|-		|-
-	| NET_ERROR_LISTENINGONCONN || Could not listen on connection.	+	| NET_ERROR_LISTENINGONCONN || - Could not listen on connection.
	|-		|-
-	| NET_ERROR_ADDINGSOCKET || Could not add socket to socketset.	+	| NET_ERROR_ADDINGSOCKET || - Could not add socket to socketset.
	|-		|-
-	| 0 - n || Connection identifier. (Where n is the number of maximum allowed connections)	+	| 0 - n || - Connection identifier. (Where n is the number of maximum allowed connections)
	|}		|}
-
	== Example ==		== Example ==
-
	<pre>		<pre>
	Program example;		Program example;

---

Revision as of 15:10, 24 July 2007

Up to Network.DLL Functions

---

Contents 1 Definition 2 Parameters 3 Returns 4 Example

Definition

INT NET_Listen ( <WORD port> , [<BYTE consolereports>] )

Opens a listenconnection on a certain port. The connections accepted will inherit certain variables from the listenport they were connected on. These variables are consolereports and separator.

Parameters

WORD port	The port on which to listen.
[BYTE consolereports]	true/false: specifies whether there will be console reports for this connection (like messages).

Returns

INT : Connection identifier.

NET_ERROR_INVALIDSOCKETSET	- - The socketset is invalid.
NET_ERROR_SOCKETSETINACTIVE	- The socketset is inactive.
NET_ERROR_INVALIDPORTNUMBER	- The portnumber is invalid (<0 or >65535).
NET_ERROR_INVALIDTYPE	- The type specified is invalid.
NET_ERROR_TOOMANYCONNS	- There are too many connections
NET_ERROR_RESOLVINGHOST	- Could not resolve host.
NET_ERROR_LISTENINGONCONN	- Could not listen on connection.
NET_ERROR_ADDINGSOCKET	- Could not add socket to socketset.
0 - n	- Connection identifier. (Where n is the number of maximum allowed connections)

Example

Program example;
    include "Network.fh";
Begin

   NET_Init(0,10,1);
   NET_Listen(4555,true);
   
   Loop
     frame;
   End

End