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

NET Connect

From FenixWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 15:04, 14 April 2007 (edit)
Sandman (Talk | contribs)
m (Example)
← Previous diff
Current revision (22:42, 12 September 2007) (edit) (undo)
Sandman (Talk | contribs)
m
 
(8 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;
Line 61: Line 60:
End End
</pre> </pre>
 +
 +{{Netfuncbox}}

Current revision

Up to Network.DLL Functions



Contents

[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()
Personal tools