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

Programming CP1413plus manual
7-92 Rev. 00/07
7.6.4.2.6 Get a list of connections from the specified file
#include <MSGINDEX.H>
#include <S5ACCESS.H>
unsigned short WENTRY_C S5ListeNetVerbindungen(char W_POINTER
Dateiname, short len, char mem)
The function
S5ListeNetVerbindungen
returns a list with all the names of the connections
that have been entered into the file. You may use this function to check whether a specific
connection exists or not..
Parameters
Dateiname
the name of the Net file from which the list of
connections must be retrieved.
len
specifies the length of the memory area used for the
transfer.
mem
is the pointer to the memory area. The allocated length
must equal or exceed the setting in
len
.
Returns
0
OK, memory now contains the connection names
separated by null terminators and a byte.
Bit 0: the connection is in use if this is set to 1.
Bit 1: always 0
Bit 2: a 1 indicates an H1 connection
Bit 3: a 1 indicates a TCP/IP connection
Bit 4: a 1 indicates a send connection
(SEND DIRECT)
Bit 5: a 1 indicates a receive connection
(RECEIVE DIRECT)
The list ends with two null terminators.
TEXT_NO_NET_FILE the connection file does not exist.
Note
This function makes use of files. It is therefore not possible to call the function from
a driver.
See also
H1LeseParameter
H1SchreibeParameter
S5LeseParameter
S5SchreibeParameter