handle_close_many - close a number of handles
#include <zircon/syscalls.h>
zx_status_t zx_handle_close_many(zx_handle_t* handles, size_t num_handles);
handle_close_many() closes a number of handles, causing each underlying object to be reclaimed by the kernel if no other handles to it exist.
If a handle was used in a pending object_wait_one or a object_wait_many call, the wait will be aborted.
This operation closes all handles presented to it, even if one or more of the handles is duplicate or invalid.
It is not an error to close the special "never a valid handle" ZX_HANDLE_INVALID, similar to free(NULL) being a valid call.
No rights are required.
handle_close_many() returns ZX_OK on success.
ZX_ERR_BAD_HANDLE One of the handles isn't a valid handle, or the same handle is present multiple times.