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.

                                                      ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINPROGRAMLIST
 
BOOL PrfRemoveProgram(hini, hProgram)
HINI hini;            /* initialization-file handle */
HPROGRAM hProgram;    /* program handle             */
 
The PrfRemoveProgram function removes a program from Desktop Manager.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hini       Identifies the file that contains the program information 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.
 
hProgram   Identifies the program to remove from Desktop Manager. This
           parameter cannot be a group handle.
 
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_INI_FILE_HANDLE
     PMERR_INVALID_PIB
     PMERR_INVALID_PROGRAM_HANDLE
     PMERR_MEMORY_ALLOCATION_ERR
     PMERR_MEMORY_DEALLOCATION_ERR
 
Comments
 
You can remove a program from a group, even if the program is currently
running. Only the program information in the group is removed──the program
itself is not affected.
 
See Also
 
PrfDestroyGroup, PrfOpenProfile, WinGetLastError
 
                                      ♦