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_extract_member</h2> 12 13<hr> 14<p><b>Function</b> - Extract the specified receive right from the specified 15port set. 16<h3> 17SYNOPSIS</h3> 18 19<pre><b>kern_return_t mach_port_extract_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> set<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_extract_member</b> function removes a receive right from 50a port set. Any other port set memberships for the receive right are not 51affected. A receive right can be a member of any number of portsets 52simultaneously. 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 74<dt> 75<b>KERN_NOT_IN_SET</b></dt> 76 77<dd> 78<i>member</i> was not in <i>set</i>.</dd> 79</dl> 80 81<h3> 82RELATED INFORMATION</h3> 83Functions: 84<b><a href="/HTML/mach_port_extract_member.html">mach_port_extract_member</a></b>, 85<b><a href="/HTML/mach_port_move_member.html">mach_port_move_member</a></b>, 86<b><a href="/HTML/mach_port_get_set_status.html">mach_port_get_set_status</a></b>, 87<b><a href="/HTML/mach_port_get_attributes.html">mach_port_get_attributes</a></b>. 88</body> 89</html> 90