Function ziAPISetValueD#

ZIResult_enum ziAPISetValueD(ZIConnection conn, const char *path, ZIDoubleData value)#

asynchronously sets a double-type value to one or more nodes specified in the 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

ziAPIGetValueD. ziAPISyncSetValueD

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 to Value.

  • value – [in] The double-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_WRITEONLY on attempt to get a wrtie-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.