Function ziAPIModSetString#

ZIResult_enum ziAPIModSetString(ZIConnection conn, ZIModuleHandle handle, const char *path, const char *str)#

Sets a module parameter to the specified null-terminated string.

This function is used to configure (set) module parameters which have string types.

  • conn[in] The ZIConnection from which the module was created.

  • handle[in] The ZIModuleHandle specifying the module to set data on.

  • path[in] Path of the module parameter to set.

  • str[in] Pointer to a null-terminated string (max 64k characters).


  • ZI_INFO_SUCCESS On success.

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

  • ZI_ERROR_GENERAL If a general error occurred, use ziAPIGetLastError for a detailed error message.

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