Objective Systems, Inc.  
Home
About ASN.1
Products
Free Software
Documents
Services
Resources
Resellers
Customers
Careers
About Us
Contact Us
 

Google
Objective Systems, Inc.

Socket stream functions.

Socket stream functions are used for socket stream operations. More...

Functions

int rtxStreamSocketAttach (OSCTXT *pctxt, OSRTSOCKET socket, OSUINT16 flags)
 Attaches the existing socket handle to the stream.
int rtxStreamSocketClose (OSCTXT *pctxt)
 This function closes a socket stream.
int rtxStreamSocketCreateWriter (OSCTXT *pctxt, const char *host, int port)
 This function opens a socket stream for writing.
int rtxStreamSocketSetOwnership (OSCTXT *pctxt, OSBOOL ownSocket)
 This function transfers ownership of the socket to or from the stream instance.

Detailed Description

Socket stream functions are used for socket stream operations.

Function Documentation

int rtxStreamSocketAttach (  OSCTXT *  pctxt,
OSRTSOCKET  socket,
OSUINT16  flags
) 
 

Attaches the existing socket handle to the stream.

The socket should be already opened and connected. The 'flags' parameter specifies the access mode for the stream - input or output.

Parameters:
pctxt Pointer to a context structure variable that has been initialized for stream operations.
socket The socket handle created by rtxSocketCreate.
flags Specifies the access mode for the stream:
  • OSRTSTRMF_INPUT = input (reading) stream;
  • OSRTSTRMF_OUTPUT = output (writing) stream.
Returns:
Completion status of operation: 0 = success, negative return value is error.

int rtxStreamSocketClose (  OSCTXT *  pctxt  ) 
 

This function closes a socket stream.

Parameters:
pctxt Pointer to a context structure variable that has been initialized for stream operations.
Returns:
Completion status of operation: 0 = success, negative return value is error.

int rtxStreamSocketCreateWriter (  OSCTXT *  pctxt,
const char *  host,
int  port
) 
 

This function opens a socket stream for writing.

Parameters:
pctxt Pointer to a context structure variable that has been initialized for stream operations.
host Name of host or IP address to which to connect.
port Port number to which to connect.
Returns:
Completion status of operation: 0 = success, negative return value is error.

int rtxStreamSocketSetOwnership (  OSCTXT *  pctxt,
OSBOOL  ownSocket
) 
 

This function transfers ownership of the socket to or from the stream instance.

The socket will be closed and deleted when the stream is closed or goes out of scope. By default stream socket owns the socket.

Parameters:
pctxt Pointer to a context structure variable that has been initialized for stream operations.
ownSocket Boolean value.

This file was last modified on 8 Jan 2007.
XBinder, Version 1.1.9