Zen API | Contents | Reference | Previous | Up | Next

zReceiver_Open
zReceiver functions
C

    zStatus zReceiver_Open(zReceiver receiver, zBool isActive, zIPAddress address, z32u port);

Parameters

Parameters | Description
zReceiver receiver | zReceiver object.
zBool isActive | zTRUE for active mode; zFALSE for passive mode (see discussion below).
zIPAddress address | Active mode: local address on which to listen (or zIP_ADDRESS_ANY); Passive mode: remote server address.
z32u port | Active mode: local port on which to listen (or zIP_PORT_ANY); Passive mode: remote server port.

Description

Initates network activities for active mode or passive mode connections.

Remarks

After constructing a zReceiver object, setup functions can be used to configure the receiver. When setup is complete, zReceiver_Open begins communication activities.

In active mode, this function will cause the zReceiver to open a server port and wait for incoming data connections. In passive mode, this function will attempt to establish a data connection to a server on the network. The use of passive mode can eliminate conflicts with firewall software running in the client network. However, Passive mode was not available until FHP 2.1; older systems must use active mode.

File

zReceiver.h

Copyright (c) 2008-2010 by LMI Technologies Inc. All rights reserved.
Contents | Reference