HSE_REQ_DONE_WITH_SESSION

  • Article

If your extension is performing some form of extended processing, and its HttpExtensionProc entry-point function has returned the status code HSE_STATUS_PENDING, then your extension should notify IIS when all processing is complete by using this support function. Calling this function will terminate the session connection.

BOOL ServerSupportFunction(
      HCONN ConnID,
      DWORD dwServerSupportFunction,
      LPVOID lpvBuffer,
      LPDWORD lpdwSizeofBuffer,
      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_DONE_WITH_SESSION.

  • lpvBuffer
    Optionally points to a DWORD containing an HSE_STATUS code.

  • lpdwSizeofBuffer
    Unused in this ServerSupportFunction request type.

  • lpdwDataType
    Unused in this ServerSupportFunction request type.

Remarks

This support function must be called if the HSE_IO_DISCONNECT_AFTER_SEND parameter has been included in the HSE_TF_INFO structure, as part of an HSE_REQ_TRANSMIT_FILE request.

For the value pointed to by lpvBuffer, IIS supports HSE_STATUS_SUCCESS_WITH_KEEP_CONN for keeping IIS connections alive, if the client has also requested to keep the connection alive.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in httpext.h.

See Also