- * @return SP_OK on success, SP_ERR_FAIL on failure, SP_ERR_MEM on allocation
- * failure, or SP_ERR_ARG if an invalid pointer is passed. If any error
- * is returned, the variable pointed to by list_ptr will be set to NULL.
- * Otherwise, it will be set to point to the newly allocated array.
+ * If any error is returned, the variable pointed to by list_ptr will be set
+ * to NULL. Otherwise, it will be set to point to the newly allocated array.
+ *
+ * @return SP_OK upon success, a negative error code otherwise.