<div class="content" name="S_DSBeginDeleteNotification" uuid="8fa89cc3-1cd0-455b-81c6-3f5a72ea568c"><p>The <b>S_DSBeginDeleteNotification</b> method begins a
delete notification and returns an <a href="993fa29f-3deb-494f-b4b4-492ee945735f#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a> context handle
associated with the delete notification. </p><dl>
<dd>
<div><pre> HRESULT S_DSBeginDeleteNotification(
   [in] handle_t hBind,
   [in] const wchar_t* pwcsPathName,
   [out] PPCONTEXT_HANDLE_DELETE_TYPE pHandle,
   [in] PCONTEXT_HANDLE_SERVER_AUTH_TYPE phServerAuth
 );
</pre></div>
</dd></dl><p><b>hBind: </b> MUST specify an RPC binding handle, as
specified in <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>
section <a href="../ms-rpce/a01f5886-c485-4bcf-bb23-e0d755510ab7" data-linktype="relative-path">2</a>.</p><p><b>pwcsPathName: </b> MUST be set by the client to a pointer
to a NULL-terminated 16-bit <a href="993fa29f-3deb-494f-b4b4-492ee945735f#gt_b069acb4-e364-453e-ac83-42d469bb339e" data-linktype="relative-path">Unicode
string</a> that contains the directory service pathname, as specified in
section <a href="6e03fb44-a705-4728-acca-7c6d7b8d7396" data-linktype="relative-path">2.2.9</a>, for an
object of type MQDS_MACHINE or MQDS_QUEUE.<a id="Appendix_A_Target_157"></a><a aria-label="Product behavior note 157" href="9c868bc8-426a-4e5f-8b45-cee7d49c3d10#Appendix_A_157" data-linktype="relative-path">&lt;157&gt;</a></p><p><b>pHandle: </b> MUST be set by the server to a pointer to a
unique RPC context_handle representing the delete notification. This handle is
used by the client in subsequent calls to <a href="f9c6d19f-9de8-435b-a766-92246bb06f08" data-linktype="relative-path">S_DSNotifyDelete</a>.</p><p><b>phServerAuth: </b> A <a href="c28a1e6b-4092-4443-b69f-5814d5c4f9e4" data-linktype="relative-path">PCONTEXT_HANDLE_SERVER_AUTH_TYPE</a>
RPC context handle acquired from the <i>pphServerAuth</i> parameter in a
previous call to <a href="0e3ad7d0-6a64-480a-9f13-e94dd608d79d" data-linktype="relative-path">S_DSValidateServer</a>.
The server MUST use this parameter as a key to locate the GSS security context
used to compute the signature returned in <i>pbServerSignature</i>. See section
3.1.4.2.</p><p><b>Return Values: </b> If the method succeeds, the return
value is MQ_OK (0x00000000). If the method fails, the return value is an
implementation-specific error code.<a id="Appendix_A_Target_158"></a><a aria-label="Product behavior note 158" href="9c868bc8-426a-4e5f-8b45-cee7d49c3d10#Appendix_A_158" data-linktype="relative-path">&lt;158&gt;</a></p><p><b>MQ_OK</b> (0x00000000)</p><p><b>Exceptions Thrown:</b> No exceptions are thrown beyond
those thrown by the underlying RPC protocol, as specified in [MS-RPCE].</p><p>When processing this call, the server MUST:</p><ul><li><p><span><span> 
</span></span>Add an entry to the delete notification table as follows:</p>
<ul><li><p><span><span>  </span></span>Set
the object type to the type of object identified by <i>pwcsPathName</i>.<a id="Appendix_A_Target_159"></a><a aria-label="Product behavior note 159" href="9c868bc8-426a-4e5f-8b45-cee7d49c3d10#Appendix_A_159" data-linktype="relative-path">&lt;159&gt;</a></p>
</li><li><p><span><span>  </span></span>Set
the name to <i>pwcsPathName</i>.</p>
</li><li><p><span><span>  </span></span>Set
the owner site to the object identifier of the site owning the <a href="993fa29f-3deb-494f-b4b4-492ee945735f#gt_c1a6400d-703b-4f9a-a74c-40f1487978d9" data-linktype="relative-path">queue</a> object.<a id="Appendix_A_Target_160"></a><a aria-label="Product behavior note 160" href="9c868bc8-426a-4e5f-8b45-cee7d49c3d10#Appendix_A_160" data-linktype="relative-path">&lt;160&gt;</a></p>
</li></ul></li><li><p><span><span> 
</span></span>Also, if the object type is MQDS_QUEUE, the server MUST:</p>
<ul><li><p><span><span>  </span></span>Set
the owner <a href="993fa29f-3deb-494f-b4b4-492ee945735f#gt_476f10ed-08f0-4887-b583-59d5cf909979" data-linktype="relative-path">queue manager</a>
object identifier to the queue manager object identifier for the queue.</p>
</li><li><p><span><span>  </span></span>Set
the flag indicating if this queue is a foreign queue.</p>
</li></ul></li></ul><p>The server MUST retain this information until the client
calls the <a href="1e8a6d52-6c9d-4db8-ac2f-e39f71b2d889" data-linktype="relative-path">S_DSEndDeleteNotification</a>
method or until the <a href="152d61f0-db84-48f8-9bd4-cc4276ed8e94" data-linktype="relative-path">PCONTEXT_HANDLE_DELETE_TYPE
rundown</a> event occurs.</p></div>