PMDF popstore & MessageStore Manager's Guide
PMDF-POP-6.0
Previous
| Contents
POPSTORE_format_profile
Format for display a user profile.
FORMAT
int POPSTORE_format_profile (format, user_context, flags,
context, output_proc)
POPSTORE_format_element *format;
POPSTORE_user_context *user_context;
int flags;
void *context;
int (*output_proc)();
ARGUMENTS
format
Pointer to a formatting context returned by a previous call to
POPSTORE_format_read. Used for input only.
user_context
User context to display. Obtain this context by calling
POPSTORE_user_begin_d. Used for input only.
flags
Bit mask. Used for input only.
context
Pointer to private client data to be passed to the client-supplied
output_proc procedure. Used for input only.
output_proc
Address of a client-supplied subroutine to call to output formatted
data. Used for input only.
DESCRIPTION
POPSTORE_format_profile may be used to format for display a user
profile. The formatting context passed to this subroutine should be
derived from a formatting file using substitution strings from Tables
4-10 and 4-15 . The flags argument is
used to control the handling of the %first,
%last, %!first, and %!last
substitution strings. When the lowest bit of flags is set,
%first is true. When the second lowest bit is set,
%last is true. See the description of the
POPSTORE_format_counters subroutine for a description of the
output_proc procedure.
Return Values
| POPSTORE_SUCCESS |
Normal, successful completion. |
| POPSTORE_BADARG |
Bad value passed for the address of the output procedure,
output_proc.
|
| |
Any error value returned by the output procedure,
output_proc.
|
Previous
| Next
| Contents