This function registers file information with the H/PC, Palm-size PC Explorer.
At a Glance
| Header file: | Ppcload.h |
| Windows CE versions: | 1.0 and 1.01 |
Syntax
LOADERROR Load_RegisterFileInfo(LPCSTR szFileName,
LPCSTR szIconFile, LPCSTR szFileType, int iIcon);
Parameters
szFileName
Null-terminated string that contains the name of the 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
Null-terminated string that contains the name of the file that contains 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
Not used; set to a non-NULL string.
iIcon
Index to the icon associated with the file being loaded.
Return Values
One of the following values is returned:
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 computer—it is intended to be called from a setup program.
To ensure consistency with other icons displayed by the H/PC, Palm-size 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 versions 2.0 and later. For more information on installing applications for versions 2.0 and later, see Connection Services.
See Also