win12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
PrfReset (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINSHELLDATA
 
BOOL PrfReset(hab, pprfpro)
HAB hab;            /* anchor-block handle                    */
pprfpro pprfpro;    /* address of structure with profile data */
 
The PrfReset function resets Presentation Manager by rereading the
initialization files. This function can change which initialization files
are to be used by the system.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hab        Identifies the anchor block.
 
pprfpro    Points to the PRFPROFILE structure that contains the filenames of
           the initialization files.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
      PMERR_CALL_NOT_EXECUTED
      PMERR_MEMORY_ALLOC
      PMERR_MEMORY_ALLOCATION_ERR
      PMERR_MEMORY_DEALLOCATION_ERR
      PMERR_MEMORY_SHARE
      PMERR_OPEN_QUEUE
      PMERR_WRITE_QUEUE
 
Comments
 
The system is reset by rereading the initialization files that are specified
in the PRFPROFILE structure. Both initialization files must be specified
before calling this function.
 
If the path is not included as part of the initialization-file names, the
current directory is used.
 
The PrfReset function modifies the PRFPROFILE structure passed to it. Before
you can use this structure again, you must reinitialize its values.
 
See Also
 
PrfQueryProfile, PRFPROFILE, WinGetLastError