## mach_port_move_member

Function - Move the specified receive right into or out of the specified port set.

### SYNOPSIS

    kern_return_t   mach_port_move_member
                    (ipc_space_t                               task,
                     mach_port_name_t                        member,
                     mach_port_name_t                         after);

### PARAMETERS

task
  [in task send right] The task holding the port set and receive right.
member
  [in scalar] The task's name for the receive right.
after
  [in scalar] The task's name for the port set.

### DESCRIPTION

The mach_port_move_member function moves a receive right into a port set. If the receive right is already a member of any other port sets, it is removed from those sets first. If the port set is MACH_PORT_NULL, then the receive right is not put into a port set, but removed from all its current port sets.

### NOTES

This interface is machine word length specific because of the port name parameter.

### RETURN VALUES

KERN_INVALID_NAME
  member or after did not denote a right.
KERN_INVALID_RIGHT
  member denoted a right, but not a receive right, or after denoted a right, but not a port set.
KERN_NOT_IN_SET
  after was MACH_PORT_NULL, but member wasn't currently in a port set.

### RELATED INFORMATION

Functions: mach_port_insert_member, mach_port_extract_member, mach_port_get_set_status, mach_port_get_attributes.