PMDF Programmer's Reference Manual
PMDF-PRM-6.0

Previous | Contents

PMDF_dequeue_message

Remove a message from PMDF's message queues.

VMS FORMAT

status = PMDF_dequeue_message (dq_context)

argument information
Argument Data type Access Mechanism
dq_context context pointer read/write reference

C FORMAT

status = PMDFdequeueMessage (dq_context)

argument information 
int PMDFdequeueMessage (dq_context) 
         PMDF_dq **dq_context;

ARGUMENTS

dq_context

A message dequeue context created with PMDF_dequeue_initialize.

DESCRIPTION

NOTE: Although still supported, this routine is now considered obsolete. Instead use the PMDF_dequeue_message_end routine. If calls to PMDF_recipient_disposition were made prior to calling PMDF_dequeue_message, then PMDF will automatically generate any required notification messages when PMDF_dequeue_message is called. Once any notification messages have been generated, the message being dequeued is then permanently removed from the message queue.
Return Values
PMDF__OK Normal, successful completion.
PMDF__BADCONTEXT Illegal or corrupt context. Message not dequeued.

Previous | Next | Contents