3.3.1.1 PCONTEXT_HANDLE_DELETE_TYPE RPC Context Handle

  • Article

This is an RPC context handle that represents an in-progress directory object delete notification.

A protocol client acquires a PCONTEXT_HANDLE_DELETE_TYPE RPC context handle through a call to the S_DSBeginDeleteNotification method. Each instance of this RPC context handle represents internal state that the server needs to maintain. The server SHOULD register a rundown method to close these context handles in the event that the client fails to call the S_DSEndDeleteNotification method.

The server MUST maintain the following state in the delete notification table.

For deleting queues, the internal state that the server MUST retain includes the following:

  • The object type of the object being deleted (either MQDS_QUEUE or MQDS_MACHINE).

  • The object pathname.

  • The object identifier of the owner site.<150>

Also, if the object being deleted is an MQDS_QUEUE, the server MUST retain the following information:

  • The object identifier of the queue manager that owns the queue being deleted.

  • A flag indicating if this queue is a foreign queue.

The server MUST retain this information until the client closes the context handle through a call to the S_DSEndDeleteNotification method.