PMDF Programmer's Reference Manual


Previous Next Contents Index


PMDFgetPostmasterAddress

Obtain the local postmaster's address.

PASCAL

status = PMDF_get_postmaster_address

(address, address_len)

argument information
Argument Data type Access Mechanism
address descriptor read/write reference
address_len unsigned word write reference

C

status = PMDFgetPostmasterAddress

(address, address_len)

argument information


int PMDFgetPostmasterAddress(char *address, int *address_len) 


Arguments

address

String to receive the local postmaster's address. Length must be at least ALFA_SIZE+1 bytes.

address_len

Length in bytes of the postmaster's address. Callers using PMDFgetpostmasteraddress must, on input, supply the maximum length in bytes of address.

Description

PMDFgetPostmasterAddress can be used to obtain the mail address for the local postmaster. Note, however, that it usually is not a good idea for programs to send mail to the postmaster. In many situations, sending mail to the postmaster when failures occur can lead to mail loops; e.g., the mail sent to the postmaster itself fails and generates a message to the postmaster which then fails and generates yet another message to the postmaster, ad infinitum.

Return Values

PMDF__OK Normal, successful completion.
PMDF__FATERRLIB Call to LIB$SCOPY_R_DX failed owing to a fatal internal error in the OpenVMS Run Time Library. No address returned.
PMDF__INSVIRMEM Insufficient virtual memory: call to LIB$GET_VM made by LIB$SCOPY_R_DX has failed. No address returned.
PMDF__INVSTRDES Invalid string descriptor for address: descriptor has an invalid value in its DSC$B_CLASS field. No address returned.
PMDF__STRTRU Supplied string was too long; value truncated to fit.


Previous Next Contents Index