beautypg.com

Com return values, Datalogger.loggerconnectstart(), Name – Campbell Scientific LoggerNet-SDK Software Development Kit User Manual

Page 106: Parameters, Description

background image

Section 17. CsiDatalogger Control Reference

COM Return Values

Table of Possible Values

Code Meaning

S_OK

Success: Normal return

Datalogger.loggerConnectStart()

Name

Datalogger.loggerConnectStart(logger_priority_type
priority)

Parameters

The following values indicate the priority of maintaining the connection when
other devices might need the resources:

Table of 'priority' values:

priority_high = 0

priority_normal = 1

priority_low = 2

Description

This method will open a persistent connection to the specified datalogger.
Keeping the connection open will allow the LoggerNet server to handle
multiple transactions without disconnecting. The default behavior of the server
is to disconnect from the datalogger after finishing each task, such as a
clockCheckStart. Keeping the connection open is very helpful if it takes a
considerable amount of time for the server to connect to a datalogger, such as
on a dialup connection.

This method should only be called when the value of serverConnected, is true.
If not, this method will return

E_CSI_NOT_CONNECTED

. This method triggers

onLoggerConnectStarted, or onLoggerConnectFailure, depending on its
success or failure.

COM Return Values

Table of Possible Values

Code Meaning

S_OK

Success: Normal return

E_CSI_BUSY

Error: A persistent communications link has
already been started with this datalogger

E_CSI_FAIL

Error: Unexpected error

E_CSI_NOT_CONNECTED

Error: Not connected to the LoggerNet server

17-8