The program list call hook is 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, ProgramListExitHook, lets applications or system components do the following:

• Implement the initialization file and program list partially, while 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 ProgramListEntryHook(HAB hab,                                   PPRFHOOKPARMS pProfileHookParams,
                                   PBOOL fNoExecute);

The hab parameter is the anchor block handle.

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

The fNoExecuteparameter is the suppress indicator and is either TRUE or FALSE. If set to TRUE by any hook procedure, no further processing of the call is done. If set to FALSE by all hook procedures, the call is processed normally.

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