HSE_REQ_SEND_RESPONSE_HEADER_EX

  • Article

This support function is an improved version of the support function HSE_REQ_SEND_RESPONSE_HEADER. You can use this support function to request that IIS send a complete HTTP response header to the client browser, including the HTTP status, server version, message time, and MIME version. Your extensions can also, optionally, append other header information to the end of IIS-generated header, such as Content-Type or Content-Length. In addition, this version of the support function can be used with the HSE_SEND_HEADER_EX_INFO Structure to specify whether the connection should be kept open, and the lengths of the header and status strings.

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

  • lpvBuffer
    Points to an HSE_SEND_HEADER_EX data structure that contains the connection, header, and status information that will be included in the HTTP response headers.

  • lpdwSizeofBuffer
    Unused in this ServerSupportFunction request type.

  • lpdwDataType
    Unused in this ServerSupportFunction request type.

Remarks

In general, by specifying the lengths of the header and status strings, you can expect better performance from this support function than you can from the older version, HSE_REQ_SEND_RESPONSE_HEADER.

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.