HK_PLIST_EXIT - Program List Exit Hook

The program list exit hook called every time a program-list call or initialization file call is invoked by an application. It is called before the call is run. This hook, together with its counterpart, ProgramListEntryHook, lets applications or system components:

• Implement the initialization file and program list partially, whilst retaining the existing implementation. For example, read-only requests could be satisfied from memory, rather than from disk.

• Redirect initialization-file operations on a particular group to an alternative (opened) profile. For example, in a multiple-user environment, a LAN program might choose to redirect profile groups that are hardware-dependent, rather than user-dependent, to the system-initialization file.

BOOL EXPENTRY ProgramListExitHook(HAB hab,                                  PPRFHOOKPARMS pProfileHookParams);

The hab parameter is the anchor block handle.

The pProfileHookParams parameter is the profile hook parameters. These identify the call and give its parameters and return code.

This function returns either TRUE or FALSE. If it returns TRUE, the next hook in the chain is not called. If it returns FALSE, the next hook in the chain is called.