![background image](http://html.mh-extra.com/html/omron/sysmac-3g8f7-clk12-ev1/sysmac-3g8f7-clk12-ev1_operation-manual_1633421080.webp)
60
Library Functions
Section 4-1
The function will end in an error if access is requested to 3 or more different
memory areas for one CLK handle. (Detailed error information =
ERR_MEMORY_AREA: Multiple memory area specification error)
The function will end in an error if a memory name specified in the argument
does not exist. (Detailed error information = ERR_NO_MEM_TYPE: No such
memory)
4-1-7
ClkGetNetworkStatus()
Network Status Read
Function
Reads the network status.
Call Format
INT ClkGetNetworkStatus(PCLKHANDLE hCLK, BYTE byNet, PNST-
BUFFER pBuffer);
Return Value
CLK_SUCCESS is returned if the function ends normally.
CLK_ERROR is returned if the function ends in an error. Detailed error infor-
mation can be obtained using ClkGetLastError().
Description
Refer to
Structure Descriptions
for information on the read data structure.
The read data size is fixed. Provide a memory area the size of the PNST-
BUFFER structure as a read data storage buffer.
If the function is executed for a Board that is not part of a network, 0 will be set
for the following members of the read data structure.
Network participation status
Communications cycle time
Polling node address
Data link operation status and data link mode
Data link status
The function will end in an error if an error response code is returned for the
FINS message. (Detailed error information = ERR_RESPONSE: Error
response code error)
The function will end in an error if a Controller Link Support Board is not
mounted for the network specified by the Board network address specified as
an argument. (Detailed error information = ERR_NO_CLKUNIT: No CLK Unit)
The function will end in an error if a message reception area cannot be
obtained because of insufficient memory. (Detailed error information =
ERR_NO_MEMORY: Memory acquisition error).
The function will end in an error if a network address of 0 is specified when
there is more than one network. (Detailed error information =
ERR_NETWORK_ADDRESS).
Type
Variable name
Description
PCLKHANDLE
hCLK
The CLK handle obtained with ClkO-
pen()
BYTE
byNet
Network address of the Broad to read
network status
PNSTBUFFER
pBuffer
Pointer to the buffer structure to store
the read data
Arguments
Summary of Contents for SYSMAC 3G8F7-CLK12-EV1
Page 2: ......
Page 4: ...iv ...
Page 20: ...xx Conformance to EC Directives 6 ...
Page 48: ...28 Applications Precautions Section 1 4 Example CX Programmer Response Timeout Setting ...
Page 68: ...48 Backup Power Supply Wiring Optical Ring Systems Only Section 2 4 ...
Page 74: ...54 Using the C Library Section 3 2 ...
Page 110: ...90 Changing the Data Link Tables with Active Data Links Section 5 5 ...
Page 187: ......