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.
GpiUnloadFonts (1.2)
◄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
♦