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

NET RecvVar

From FenixWiki

Revision as of 19:59, 12 September 2007 by Sandman (Talk | contribs)
(diff) ←Older revision | Current revision (diff) | Newer revision→ (diff)
Jump to: navigation, search

Up to Network.DLL Functions



Contents

Definition

INT NET_RecvVar ( <WORD connection> , <BYTE POINTER data> , <INT length> , [<BYTE includeseparator>] )

The receiving equivalent of NET_SendVar(): stores the data at the specified pointer, unlike NET_GetMessage(), which returns the message as a string, not allowing some variables.

Parameters

WORD connection - The connection identifier.
BYTE pointer message - The pointer the data/variable will be written to.
INT length - The length/size of the data/variable.
[BYTE includeseparator] - true/false: whether the connection's separator will be added to the received data at the end. Default is false.

Returns

INT : The size of the successfully received message. Without the separatorlength.

NET_ERROR_INVALIDCONN - The connection is invalid.
NET_ERROR_CONNINACTIVE - The connection is inactive.
NET_ERROR_NONEWMESSAGE - The incomingbuffer is empty.
NET_ERROR_UNFINISHEDMESSAGE - The message in the incomingbuffer is incomplete.
NET_ERROR_SIZEMISMATCH - Sizes do not match (length and the length of the received message(s)).
>=0 - The size of the successfully received message. Without the separatorlength.

Notes

This function is mainly to receive data sent with NET_SendVar().

Personal tools