NAME

TerminateExtension - tidy-up routine of an ISAPI extension.


SYNOPSIS

 #include "httpext.h"
 extern BOOL TerminateExtension ( dword dwFlags ) {
    /* do the job */
    return TRUE;
 }


DESCRIPTION

TerminateExtension tidies up persistent resources related to an ISAPI extension. It is called just before the extension is unloaded - typically during shutdown of the web server, but possibly earlier if the web server determines that it no longer needs the extension loaded.

On Tru64 UNIX (because of complications in that OS's handling of shared libraries) TerminateExtension must appear in the shared library which implements the extension - if the extension depends on further shared libraries, it can only use these to provide the tools needed by its interfaces; it cannot delegate, to them, provision of the ISAPI interface functions themselves.


PARAMETER

dwFlags

The one parameter, dwFlags, indicates the context of the shut-down. It currently only has one value: HSE_TERM_MUST_UNLOAD.


RETURN

Return TRUE on success; FALSE otherwise.


SEE ALSO

isapi(7), GetExtensionVersion(3), HttpExtensionProc(3), TerminateFilter(3).


FILES

$ZEUSHOME/web/include/httpext.h $ZEUSHOME/web/include/wintypes.h $ZEUSHOME/webadmin/docroot/docs/modules/isapi/*.html


NOTES

Given that power outages and similar unplanned termination of the web server cannot be relied on to allow for orderly shut-down, extension authors are advised not to rely on TerminateExtension being called.


COPYRIGHT

Copyright (C) 2000-2001 Zeus Technology Limited. All rights reserved.