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

From FenixWiki

Revision as of 13:18, 14 April 2007 (edit) Sandman (Talk | contribs) ← Previous diff		Current revision (22:42, 12 September 2007) (edit) (undo) Sandman (Talk | contribs) m
(10 intermediate revisions not shown.)
Line 1:		Line 1:
	[[Category:functions]]		[[Category:functions]]
	[[Category:networkdll]]		[[Category:networkdll]]
		+	[[Category:dll]]
		+
		+	[[Functioncategory:Networkdll|'''Up to Network.DLL Functions''']]
		+	----
		+
	==Definition==		==Definition==
		+	'''INT''' NET_Connect ( <'''STRING''' address> , <'''WORD''' port> , [<'''BYTE''' consolereports>] )
-	'''INT''' NET_Connect ( '''STRING''' address , '''WORD''' port , ['''BYTE''' consolereports] )	+	Opens a connection to the specified address on the specified port.
-		+
-	Opens a connection to the specified address on the specified port.<br />	+
-	Also called NET_Open().	+
		+	Also called [[NET_Open]]().
	== Parameters ==		== Parameters ==
-
	{|		{|
-	| '''STRING''' address || The address to which will be connected.	+	| '''STRING''' address || - The address to which will be connected.
	|-		|-
-	| '''WORD''' port || The port on which will be connected.	+	| '''WORD''' port || - The port on which will be connected.
	|-		|-
-	| ['''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_CONNECTING || Could not connect.	+	| NET_ERROR_CONNECTING || - Could not connect.
	|-		|-
-	| 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_Connect("www.google.com",80,true);	+	NET_Connect("www.google.com",80,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_Connect ( <STRING address> , <WORD port> , [<BYTE consolereports>] )

Opens a connection to the specified address on the specified port.

Also called NET_Open().

[edit] Parameters

STRING address	- The address to which will be connected.
WORD port	- The port on which will be connected.
[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_CONNECTING	- Could not connect.
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_Connect("www.google.com",80,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()