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.
PrfDestroyGroup (1.2)
                                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINPROGRAMLIST
 
BOOL PrfDestroyGroup(hini, hGroup)
HINI hini;          /* initialization-file handle */
HPROGRAM hGroup;    /* group handle               */
 
The PrfDestroyGroup function removes a group and all program information
contained within that group from Desktop Manager.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hini       Identifies the file that contains the group to remove. This
           parameter can be an initialization-file handle obtained by using
           the PrfOpenProfile function, or it can be the value
           HINI_USERPROFILE, specifying the user-profile file.
 
hGroup     Identifies the group to be removed from Desktop Manager.
 
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_GROUP_PROTECTED
     PMERR_INVALID_GROUP_HANDLE
     PMERR_INVALID_TARGET_HANDLE
     PMERR_MEMORY_ALLOCATION_ERR
     PMERR_MEMORY_DEALLOCATION_ERR
     PMERR_NOT_CURRENT_PL_VERSION
     PMERR_NOT_IN_IDX
 
Comments
 
You cannot remove a group that is protected. You can remove a group that
contains programs.
 
See Also
 
PrfCreateGroup, PrfOpenProfile, WinGetLastError