genders_handle_destroy() destroys the genders handle pointed to
by handle and frees all allocated memory associated with it.
RETURN VALUES
On success, 0 is returned. On error, -1 is returned, and an error
code is returned in handle. The error code can be retrieved via
genders_errnum(3)
, and a description of the error code can be retrieved via
genders_strerror(3).
Error codes are defined in genders.h.
ERRORS
GENDERS_ERR_NULLHANDLE
The handle parameter is NULL. The genders handle must be
created with
genders_handle_create(3).
GENDERS_ERR_MAGIC
handle has an incorrect magic number. handle does not
point to a genders handle or handle has already been destroyed.