1<h2>do_mach_notify_port_destroyed</h2>
2<hr>
3<p>
4<strong>Server Interface</strong> - Handle the current instance of a port-destroyed notification.
5<h3>SYNOPSIS</h3>
6<pre>
7<strong>kern_return_t   do_mach_notify_port_destroyed</strong>
8                <strong>(notify_port_t</strong>                           <var>notify</var>,
9                 <strong>mach_port_receive_t</strong>                       <var>name</var><strong>);</strong>
10
11
12<strong>kern_return_t   do_seqnos_mach_notify_port_destroyed</strong>
13                <strong>(mach_port_t</strong>                             <var>notify</var>,
14                 <strong>mach_port_seqno_t</strong>                        <var>seqno</var>,
15                 <strong>mach_port_receive_t</strong>                       <var>name</var><strong>);</strong>
16</pre>
17<h3>PARAMETERS</h3>
18<dl>
19<p>
20<dt> <var>notify</var> 
21<dd>
22[in notify (receive) right]
23The port to which the notification was sent.
24<p>
25<dt> <var>seqno</var> 
26<dd>
27[in scalar]
28The sequence number of this message relative to the
29notification port.
30<p>
31<dt> <var>name</var> 
32<dd>
33[in scalar]
34The invalid name.
35</dl>
36<h3>DESCRIPTION</h3>
37<p>
38A <strong>do_mach_notify_port_destroyed</strong> function is called by
39<strong>notify_server</strong> as the
40result of a kernel message indicating that a receive right would have
41been destroyed.  <var>notify</var> is the port named via 
42<strong>mach_port_request_notification</strong> or <strong>mach_msg</strong>.
43<h3>NOTES</h3>
44<p>
45This interface is machine word length specific because of the port name
46parameter.
47<h3>RETURN VALUES</h3>
48<p>
49Only generic errors apply.
50<h3>RELATED INFORMATION</h3>
51<p>
52Functions:
53<a href="notify_server.html"><strong>notify_server</strong></a>,
54<a href="seqnos_notify_server.html"><strong>seqnos_notify_server</strong></a>,
55<a href="mach_msg.html"><strong>mach_msg</strong></a>,
56<a href="MP_request_notification.html"><strong>mach_port_request_notification</strong></a>,
57<a href="do_mach_notify_dead_name.html"><strong>do_mach_notify_dead_name</strong></a>,
58<a href="do_mach_notify_no_senders.html"><strong>do_mach_notify_no_senders</strong></a>,
59<a href="do_mach_notify_send_once.html"><strong>do_mach_notify_send_once</strong></a>.
60