NAME

ECloseEngine: Release an engine handle. (V47)

SYNOPSIS

ECloseEngine(EEngine)

VOID ECloseEngine(struct EGlyphEngine *);

FUNCTION

This function is similar to bullet.library/CloseEngine() but does not use a (hidden) "BulletBase" variable that may hold the library base of the wrong font engine if not set properly. It uses EEngine->ege_BulletBase as base of the font engine library to be called.

This function releases the engine handle acquired with EOpenEngine(). It first releases any data acquired with EObtainInfoA() associated with the engine handle that has not yet been released.

INPUTS

EEngine: the handle acquired via EOpenEngine(). If NULL or EEngine->ege_GlyphEngine is NULL, no operation is performed.

RESULT

EEngine->ege_GlyphEngine is set to NULL. The only error that can occur is when an invalid engine handle is supplied: the application is assumed not to do that.

EXAMPLE

EndGame(code, arg1, arg2, arg3, arg3)
{

...
if (EEngine->ege_GlyphEngine != NULL)

ECloseEngine(EEngine);

if (EEngine->ege_BulletBase != NULL)

CloseLibrary(EEngine->ege_BulletBase);

...