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

From FenixWiki

Revision as of 13:22, 14 April 2007 (edit) Sandman (Talk | contribs) ← Previous diff		Current revision (22:46, 12 September 2007) (edit) (undo) Sandman (Talk | contribs) m
(7 intermediate revisions not shown.)
Line 1:		Line 1:
	[[Category:functions]]		[[Category:functions]]
	[[Category:networkdll]]		[[Category:networkdll]]
		+	[[Category:dll]]
-	==Definition==	+	[[Functioncategory:Networkdll|'''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;
		+	include "Network.fh";
	Begin		Begin
-	NET_Init(0,10,1);	+	NET_Init(0,10,1);
-	NET_Listen(4555,true);	+	NET_Listen(4555,true);
-	Loop	+	Loop
-	frame;	+	frame;
-	End	+	End
	End		End
	</pre>		</pre>
		+
		+	{{Netfuncbox}}

---

Current revision

Up to Network.DLL Functions

---

Contents 1 Definition 2 Parameters 3 Returns 4 Example

[edit] 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.

[edit] 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).

[edit] 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)

[edit] Example

Program example;
    include "Network.fh";
Begin

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

End

Network.DLL Functions
Global	NET_Init() • NET_Quit() • NET_Version() • NET_IntVersion() • NET_About() • NET_GetError() • NET_Stat_Buffer() • NET_IntToIP() • NET_IPToInt()
Connections	NET_Connect() • NET_Listen() • NET_Disconnect() • NET_DisconnectAll()
Connection	NET_Resolve() • NET_Hostname() • NET_IPAddress() • NET_Port() • NET_Separator() • NET_GetSeparator() • NET_GetSeparatorLength()
Transfer	NET_Recv() • NET_RecvFile() • NET_RecvGraph() • NET_RecvVar() • NET_Send() • NET_SendFile() • NET_SendGraph() • NET_SendRN() • NET_SendVar()