KnHandleClose()

This function is declared in the coresrv/handle/handle_api.h file.

Retcode KnHandleClose(Handle handle);

Deletes the handle.

If successful, the function returns rcOk, otherwise it returns an error code.

Deleting a handle does not invalidate its ancestors and descendants (in contrast to revoking a handle, which actually invalidates the descendants of the handle – see KnHandleRevoke() and KnHandleRevokeSubtree()). When a handle is deleted, the integrity of the handle inheritance tree is also preserved. The location of a deleted handle is taken over by its parent, which becomes the immediate ancestor of the descendants of the deleted handle.