HSE_RESPONSE_VECTOR Structure

  • Article

The HSE_RESPONSE_VECTOR structure holds data about response elements used by the HSE_REQ_VECTOR_SEND support function.

Note

If the HSE_IO_SEND_HEADERS flag is used, pszStatus and pszHeaders must not be NULL. If HSE_IO_SEND_HEADERS is not present, pszStatus and pszHeader must be NULL. Any other combination is invalid.

typedef struct _HSE_RESPONSE_VECTOR HSE_RESPONSE_VECTOR {
   DWORD dwFlags;
   LPSTR pszStatus;
   LPSTR pszHeaders;
   DWORD nElementCount;
   LPHSE_VECTOR_ELEMENT lpElementArray;
} HSE_RESPONSE_VECTOR, *LPHSE_RESPONSE_VECTOR;

Members

  • dwFlags
    The following response-related flags are valid:

    Value

    Meaning

    HSE_IO_ASYNC

    Specifies asynchronous response.

    HSE_IO_CACHE_RESPONSE

    This flag instructs IIS to populate the cache with the response elements defined in the HSE_RESPONSE_VECTOR. The cache population succeeds only if HSE_IO_FINAL_SEND is also set, and this HSE_RESPONSE_VECTOR constitutes the entire response for a given request.

    HSE_IO_DISCONNECT_AFTER_SEND

    Specifies closing the connection after sending the response.

    HSE_IO_FINAL_SEND

    Instructs IIS to not send any more response data after calling HSE_REQ_VECTOR_SEND with this flag set.

    HSE_IO_SEND_HEADERS

    Specifies that headers and status are included with the response.

    HSE_IO_SYNC

    Specifies synchronous response.

  • pszStatus
    Specifies the status line to send on the response

  • pszHeaders
    A list of response headers.

  • nElementCount
    Number of HSE_VECTOR_ELEMENT elements that the lpElementArray points to.

  • lpElementArray
    A pointer to an array of HSE_VECTOR_ELEMENT structures.

Remarks

IIS 6.0 requires the HSE_IO_FINAL_SEND flag with HSE_REQ_VECTOR_SEND for the response to be cached. This restriction does not apply to IIS 7.0.

Requirements

Server: Requires or Windows Server 2003.

Product: IIS

Header: Declared in httpext.h.

See Also