Call this method to notify the ISAPI extension that a critical error has occurred.

BOOL SetCriticalIsapiError(
   DWORD dwErr = 1 
) throw( );

Parameters

dwErr

The error that occurred. This value can also be the ID of a string resource containing a plain text description of the error that can be used in the Windows Event Log and returned as part of an HTTP response.

Return Value

Returns FALSE if ATL_NO_CRITICAL_ISAPI_ERROR is defined. Returns TRUE otherwise.

Remarks

This method is called during GetExtensionVersion when an error occurs during initialization.

By default this method stores the error code so that it can be retrieved by calling GetCriticalIsapiError, loads the error message from a resource, writes the message to the Event Log and returns TRUE.

When ATL_NO_CRITICAL_ISAPI_ERROR is defined, this method ignores the error and simply returns FALSE.

See Also

CIsapiExtension Overview | Class Members | CIsapiExtension::GetCriticalIsapiError | CIsapiExtension::ReturnCriticalError