1<h2>mach_port_set_mscount</h2> 2<hr> 3<p> 4<strong>Function</strong> - Change the target port's make-send count. 5<h3>SYNOPSIS</h3> 6<pre> 7<strong>kern_return_t mach_port_set_mscount</strong> 8 <strong>(ipc_space_t</strong> <var>task</var>, 9 <strong>mach_port_name_t</strong> <var>name</var>, 10 <strong>mach_port_mscount_t</strong> <var>mscount</var><strong>);</strong> 11</pre> 12<h3>PARAMETERS</h3> 13<dl> 14<p> 15<dt> <var>task</var> 16<dd> 17[in task send right] 18The task owning the receive right. 19<p> 20<dt> <var>name</var> 21<dd> 22[in scalar] 23<var>task</var>'s name for the receive right. 24<p> 25<dt> <var>mscount</var> 26<dd> 27[in scalar] 28New value for the make-send count for the receive right. 29</dl> 30<h3>DESCRIPTION</h3> 31<p> 32The <strong>mach_port_set_mscount</strong> function changes the make-send 33count of <var>task</var>'s 34receive right named <var>name</var>. 35A port's make-send count specifies the number of send rights that have 36been generated via the port's receive right. A port's make-send count 37is set to zero when the port is first allocated; the count is reset to 38zero each time the port's receive right is transferred via a Mach message. 39<h3>NOTES</h3> 40<p> 41This interface is machine word length specific because of the port name 42parameter. 43<h3>RETURN VALUES</h3> 44<dl> 45<p> 46<dt> <strong>KERN_INVALID_NAME</strong> 47<dd> 48<var>name</var> did not denote a right. 49<p> 50<dt> <strong>KERN_INVALID_RIGHT</strong> 51<dd> 52<var>name</var> denoted a right, but not a receive right. 53</dl> 54<h3>RELATED INFORMATION</h3> 55<p> 56Functions: 57<a href="mach_port_get_attributes.html"><strong>mach_port_get_attributes</strong></a>. 58