GreUnLoadFont

GreUnLoadFont unloads the private font definitions previously loaded from the resource file indicated by pszFilename.

This function is supported by the graphics engine.

Syntax

GreUnLoadFont(pszFilename, pInstance, lFunction)

Parameters

pszFilename (PSZ) - input

Pointer to a NULL-terminated string containing the file path and name of the font file.

pInstance (PVOID) - input

Pointer to instance data.

lFunction (ULONG) - input

High-order WORD=flags; low-order WORD=NGreUnLoadFont.

Return Code

fSuccess (BOOL) - returns

Return codes.

On completion, the handling routine must return BOOLEAN (fSuccess).

• TRUE Successful
• FALSE Error

Possible Errors Detected: When an error is detected, the graphics engine calls WinSetErrorInfo to post the condition. Reasons for failure of this function include:

• PMERR_BASE_ERROR
• PMERR_FONT_FILE_NOT_LOADED

Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation.

Remarks

Before unloading any fonts, the caller must ensure that:

• The fonts are not in use for the current character set.
• The relevant lcids have been deleted (see GreDeleteSetId).