PMDF Programmer's Reference Manual


Previous 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