PMDF popstore & MessageStore Manager's Guide


Previous Next Contents Index


POPSTORE_format_profiles

Obsolete subroutine: use the more general POPSTORE_format_profiles_d subroutine.
FORMAT


int POPSTORE_format_profiles (format, user, user_len, 
                              context, output_proc) 
      POPSTORE_format_element  *format; 
      char                     *user; 
      int                       user_len; 
      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

Name of the user to display profile information for. This string can contain wild cards. Used for input only.

user_len

Length in bytes of the username string, user. Length of this string cannot exceed ALFA_SIZE bytes. 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

While use of this subroutine is still supported, it is now obsolete. Use the more general POPSTORE_format_profiles_d subroutine instead.

Return Values

POPSTORE_SUCCESS Normal, successful completion.
POPSTORE_BADARG Bad value passed for the address of the output procedure, output_proc.
POPSTORE_TOOLONG Length of username string exceeds ALFA_SIZE bytes.
  Any error value returned by the output procedure, output_proc.


Previous Next Contents Index