Function ziAPISetValueI#

ZIResult_enum ziAPISetValueI(ZIConnection conn, const char *path, ZIIntegerData value)#

asynchronously sets an integer-type value to one or more nodes specified in a path

This function sets the values of the nodes specified in path to Value. More than one value can be set if a wildcard is used. The function sets the value asynchronously which means that after the function returns you have no security to which value it is finally set nor at what point in time it is set.

See also

ziAPIGetValueI. ziAPISyncSetValueI

Parameters:

  • conn – [in] Pointer to the ziConnection for which the value(s) will be set

  • path – [in] Path to the Node(s) for which the value(s) will be set

  • value – [in] The int-type value that will be written to the node(s)

Returns:

  • ZI_INFO_SUCCESS on success.

  • ZI_ERROR_CONNECTION when the connection is invalid (not connected) or when a communication error occurred.

  • ZI_ERROR_LENGTH if the Path’s Length exceeds MAX_PATH_LEN.

  • ZI_ERROR_READONLY on attempt to set a read-only node.

  • ZI_ERROR_COMMAND on an incorrect answer of the server.

  • ZI_ERROR_SERVER_INTERNAL if an internal error occurred in the Data Server.

  • ZI_WARNING_NOTFOUND if the given path could not be resolved or no node given by path is able to hold values

  • ZI_ERROR_TIMEOUT when communication timed out.

  • Other return codes may also be returned, for a detailed error message use ziAPIGetLastError.