1<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> 2<html> 3<head> 4 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> 5 <meta name="GENERATOR" content="Mozilla/4.73 (Macintosh; U; PPC) [Netscape]"> 6 <title>mach_port_insert_member.html</title> 7</head> 8<body> 9 10<h2> 11mach_port_insert_member</h2> 12 13<hr> 14<p><b>Function</b> - Move the specified receive right into or out of the 15specified port set. 16<h3> 17SYNOPSIS</h3> 18 19<pre><b>kern_return_t mach_port_insert_member 20</b> <b>(ipc_space_t</b> <i>task</i>, 21 <b>mach_port_name_t</b> <i>member</i>, 22 <b>mach_port_name_t</b> <i>set</i><b>);</b></pre> 23 24<h3> 25PARAMETERS</h3> 26 27<dl> 28<dt> 29<i>task</i></dt> 30 31<dd> 32[in task send right] The task holding the port set and receive right.</dd> 33 34<dt> 35<i>member</i></dt> 36 37<dd> 38[in scalar] The task's name for the receive right.</dd> 39 40<dt> 41<i>set</i></dt> 42 43<dd> 44[in scalar] The task's name for the port set.</dd> 45</dl> 46 47<h3> 48DESCRIPTION</h3> 49The <b>mach_port_insert_member</b> function adds a receive right to a port 50set. If the receive right is already a member of another port set, that 51relationship is unafected by this operation. A receive right can 52be in multiple port sets simultaneously. 53<h3> 54NOTES</h3> 55This interface is machine word length specific because of the port name 56parameter. 57<h3> 58RETURN VALUES</h3> 59 60<dl> 61<dt> 62<b>KERN_INVALID_NAME</b></dt> 63 64<dd> 65<i>member</i> or <i>set</i> did not denote a right.</dd> 66 67<dt> 68<b>KERN_INVALID_RIGHT</b></dt> 69 70<dd> 71<i>member</i> denoted a right, but not a receive right, or <i>set</i> denoted 72a right, but not a port set.</dd> 73</dl> 74 75<h3> 76RELATED INFORMATION</h3> 77Functions: 78<b><a href="HTML/mach_port_extract_member.html">mach_port_extract_member</a></b>, 79<b><a href="HTML/mach_port_move_member.html">mach_port_move_member</a></b>, 80<b><a href="HTML/mach_port_get_set_status.html">mach_port_get_set_status</a></b>, 81<b><a href="HTML/mach_port_get_attributes.html">mach_port_get_attributes</a></b>. 82</body> 83</html> 84