Load_RegisterFileInfo

The Load_RegisterFileInfo function registers file information with the H/PC Explorer.

Syntax

LOADERROR Load_RegisterFileInfo(LPCSTR szFileName, LPCSTR szIconFile, LPCSTR szFileType, int iIcon);

At a Glance

Header file: Ppcload.h
Platforms: H/PC
Windows CE versions: 1.0 and 1.01

Parameters

szFileName
Application to be loaded. It must be set prior to calling Load_RegisterFileInfo. The name should include the file extension but should not include the path.
szIconFile
File containing the icon associated with the application being loaded. It must be set prior to calling Load_RegisterFileInfo. The name should include the file extension and the directory path to the file.
szFileType
Should be set to a non-NULL string. This parameter is not currently used by the system.
iIcon
Index to the icon associated with the file being loaded.

Return Values

This function returns one of the following values:

LOAD_SUCCESS
Load process completed successfully.
LOAD_INVALID_PARAMETER
Invalid command line parameter.
LOAD_REG_ERROR
Cannot create registry entry.

Remarks

The Load_RegisterFileInfo function requires a prior successful call to the Load_Init function.

Load_RegisterFileInfo is exported by Ppcload.dll, which runs on the desktop PC—it is intended to be called from a setup program.

To ensure consistency with other icons displayed by the H/PC Explorer, icons should follow the two bit per pixel format and incorporate only the following colors: black, white, dark gray and light gray.

This function is not supported on Windows CE version 2.0. For more information on installing applications for version 2.0, see Installing Applications.

See Also

Load_Init