ma_cancel_submission(3xma) — Subroutines
(c) Digital Equipment Corporation. 1994. All rights reserved.
Name
ma_cancel_submission − Cancels the deferred delivery of a submitted message.
Syntax
OM_return_code = ma_cancel_submission(session, mts_identifier)
| Argument | Data Type | Access |
| session | OM_private_object | read only |
| mts_identifier | OM_object | read only |
| return_code | OM_return_code |
C Binding
OM_return_code ma_cancel_submission (session, mts_identifier) OM_private_object session;
OM_object mts_identifier;
Arguments
SessionAn established MA session between a Client and the Service; an instance of the Session class.
MTS IdentifierThe MTS identifier of the message the delivery of which is to be cancelled; an instance of the MTS Identifier class.
Description
This routine cancels the delivery of a message that has been submitted with a deferred delivery time. It does so without regard to the session in which the message was submitted.
Return Values
MH_RC_FEATURE_UNAVAILABLE
OM_NETWORK_ERROR
MH_RC_NO_SUCH_MESSAGE
OM_SUCCESS
OM_SYSTEM_ERROR
MH_RC_WRONG_CLASS
Plus errors returned from:
om_create
om_instance
om_put
Examples
om_status = ma_cancel_submission ( session, submitted_message_id );