This topic has not yet been rated - Rate this topic

HSE_REQ_REPORT_UNHEALTHY

IIS 6.0

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.

Important 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.

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)