VIPA CP 1413plus, Руководство пользователя, Страница: 224 / 328

Programming CP1413plus manual
7-18 Rev. 00/07
Connection parameter, error
Extract from H1Def.h
typedef struct
{
CONNECT_PARAMS CrParams; // Connection parameters
CONNREF Vnr; // Adapter number/connection number
unsigned short Fehler; // Error code as connection is established
}H1_CONNECT_PARAMS;
CrParams
CrParams contains the structure and data shown above.
Vnr
A connection is identified by an adapter number and a connection number. The type of the
Vnr parameter is
CONNREF
(defined in
h1def.h
) and it represents a 32-bit
ULONG
. The
most significant word should contain the adapter number. The least significant word is used
by the function
H1StarteVerbindung
to return the connection number. This connection
number must be used for any future function calls that relate to this connection. The
connection number may be released by the function
H1StoppeVerbindung
.
Fehler
"Fehler" (error) may contain an error message as described in H1 error messages if an
attempt to establish a connection was unsuccessful.
No. Message Description
0
OK
no error occurred, command was completed
1
H1_BAD_CR_PARAMS
invalid CRParameter
2
H1_NO_SLOT
maximum number of connections established
3
H1_WAIT_CONNECT
connection was not established or interrupted
4
H1_NOT_IMPLEMENTED
function not implemented
5
H1_BAD_LINE
invalid connection number
6
H1_WAIT_DATA
no data available
7
H1_WAIT_SEND
data has not yet been sent
8
H1_INTERNAL_ERROR
internal error
10
H1_NO_DRIVER
no driver
12
H1_BLOCKED_DATA
blocked data was received
13
H1_NO_ADAPTER
specified adapter does not exist
15
H1_NOT_SUPPORTED
function not supported
Tab. 7-9: H1 error messages