Share via

3.3.4.5 S_DSNotifyDelete (Opnum 4)

  • Article

This method instructs the server to notify the computer that owns the deleted object about the deletion.

 HRESULT S_DSNotifyDelete(
   [in] handle_t hBind,
   [in] PCONTEXT_HANDLE_DELETE_TYPE Handle
 );

hBind:  MUST specify an RPC binding handle, as specified in [MS-RPCE] section 2.

Handle:  MUST be set by the client to a pointer to an RPC context_handle acquired from a previous call to S_DSBeginDeleteNotification. This RPC context handle MUST NOT have been used in a previous call to S_DSEndDeleteNotification.

Return Values:  If the method succeeds, the return value is MQ_OK (0x00000000). If the method fails, the return value is an implementation-specific error code.

MQ_OK (0x00000000)

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC extension protocol, as specified in [MS-RPCE].

While processing this call, the server MUST:

  • Look up the handle in the delete notification table. If not found, return an implementation-specific error code.

  • If the object type in the delete notification table entry is MQDS_MACHINE, the server MAY notify the Primary Site Controller of the owner site that the machine object was deleted by the client. This specification does not mandate how this notification is performed.<161>

  • If the object type in the delete notification table entry is MQDS_QUEUE, the server MAY notify the Primary Site Controller of the owner site that the queue object was deleted by the client. This specification does not mandate how this notification is performed.<162>

  • If the object type in the delete notification table entry is MQDS_QUEUE, and if the queue is not foreign, the server MUST notify the owner queue manager that the queue object was deleted by the client. This specification does not mandate how this notification is performed.