HSE_REQ_REPORT_UNHEALTHY

  • Article

An ISAPI extension calls the HSE_REQ_REPORT_UNHEALTHY support function to report to a worker process that the ISAPI extension is in an unhealthy state. The worker process responds by setting the ISAPI Unhealthy flag to true. If the health monitoring system is enabled when the World Wide Web Publishing Service (W3SVC) pings the worker process, then the worker process will send a message to the World Wide Web Publishing Service (W3SVC) requesting that the worker process be recycled.

ms524715.alert_caution(en-us,VS.90).gifImportant Note:

Using the HSE_REQ_REPORT_UNHEALTHY support function to send a report to the worker process achieves a process recycling only when the health monitoring system is enabled for the worker process.

 
BOOL ServerSupportFunction(
   HCONN ConnID,
   DWORD dwServerSupportFunction,
   LPVOID psz_reason_unhealthy,
   LPDWORD lpdwSize,
   LPDWORD lpdwDataType
);

Parameters

  • ConnID
    Specifies the connection identifier of the client to which the response data should be sent.

  • dwServerSupportFunction
    The name of the Server Support function, which in this case must be set to HSE_REQ_REPORT_UNHEALTHY.

  • psz_reason_unhealthy
    By using this optional field, the report can include the reason for the unhealthy condition of the ISAPI extension. The reason is logged in the event log, where administrators can find it and take action. If this functionality is not desired, this parameter should be NULL.

  • lpdwSize
    NULL. Not used.

  • lpdwDataType
    NULL. Not used.

Example Code

bResult = pECB->ServerSupportFunction( 
  pECB->ConnID, 
  HSE_REQ_REPORT_UNHEALTHY, 
  &psz_reason_unhealthy, 
  NULL, 
  NULL 
);

Return Value

This support function will always return a TRUE (success) value.

Requirements

Server: Requires or Windows Server 2003.

Product: IIS

Header: Declared in httpext.h.