PMDF Programmer's Reference Manual


Previous Next Contents Index


PMDFaliasNoExpansion

Inhibit the expansion of aliases for all subsequent recipient addresses.

PASCAL

status = PMDF_alias_no_expansion (nq_context)

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

C

status = PMDFaliasNoExpansion (nq_context)

argument information


int PMDFaliasNoExpansion(PMDF_nq **nq_context) 


Arguments

nq_context

A message enqueue context created with PMDFstartMessageEnvelope.

Description

Generally, expansion of aliases should never be inhibited. However, there is at least one situation where alias expansion must be inhibited. That situation arises when a message being dequeued needs to be re-enqueued to the same channel with a subset of its envelope recipient list. That is done by enqueuing a new message, inhibiting alias expansion, specifying only the envelope addresses of the desired subset, ending the envelope, and then copying the message content verbatim with PMDFcopyMessage.

Return Values

PMDF__OK Normal, successful completion.


Previous Next Contents Index