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.

◄Function Group►  ◄Overview►  ◄Changes►               ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPILCIDS
 
BOOL GpiUnloadFonts(hab, pszModName)
HAB hab;           /* anchor-block handle        */
PSZ pszModName;    /* address of the module name */
 
The GpiUnloadFonts function unloads font definitions that were previously
loaded from the resource file specified by the pszModName parameter. Before
unloading fonts, the application must delete any local identifiers
previously assigned to the fonts. The function unloads the fonts for the
application only. If any other applications have loaded the fonts, they
remain available for those applications.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
hab         Identifies the anchor block.
 
pszModName  Points to a null-terminated string. This string must be a valid
            MS OS/2 filename. If it does not specify a path and the filename
            extension, the function appends the default extension (.dll) and
            searches for the font resource file in the directories specified
            by the libpath command in the config.sys file.
 
Return Value
 
The return value is GPI_OK if the function is successful or GPI_ERROR if an
error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_FONT_FILE_NOT_LOADED
     PMERR_FONT_NOT_LOADED
     PMERR_OWN_SET_ID_REFS
 
See Also
 
GpiCreateLogFont, GpiDeleteSetId, GpiLoadFonts, GpiSetCharSet,
WinGetLastError
 
                                      ♦