HSE_EXEC_URL_INFO Structure

  • Article

The parent ISAPI extension uses this structure to specify how to invoke a child ISAPI extension when processing ANSI data.

typedef struct _HSE_EXEC_URL_INFO HSE_EXEC_URL_INFO {
      LPSTR pszUrl;
      LPSTR pszMethod;
      LPSTR pszChildHeaders;
      LPHSE_EXEC_URL_USER_INFO pUserInfo;
      LPHSE_EXEC_URL_ENTITY_INFO pEntity;
      DWORD dwExecUrlFlags;
} HSE_EXEC_URL_INFO, * LPHSE_EXEC_URL_INFO;

Members

  • pszUrl
    The child URL to be invoked. If pszUrl is NULL or the child URL's URI-stem, excluding the query string, matches the parent's, the same request will be re-processed. Reprocessing of this ISAPI depends upon the absence of HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR, explained below.

  • pszMethod
    The new HTTP method seen by the child URL for processing. If pszMethod is NULL, this specifies that no change to the HTTP method is made and the child thereby sees the parent's HTTP method.

  • pszChildHeaders
    Pointer to the sequence of request headers seen by the child URL for processing. This member completely replaces the headers seen by the child. To pass along the parent's headers without change, set this parameter to NULL.

  • pUserInfo
    A pointer to HSE_EXEC_URL_USER_INFO, a structure that specifies custom authentication information for the child URL processing. If this pointer is NULL, the child URL inherits the authentication information from the parent.

  • pEntity
    A pointer to HSE_EXEC_URL_ENTITY_INFO, a structure that specifies entity body modifications for the child URL processing. If this pointer is NULL, the child URL has access to any outstanding and unconsumed entity body.

  • dwExecUrlFlags
    Flags that control how the child request is processed.

    Value

    Description

    HSE_EXEC_URL_NO_HEADERS

    This flag suppresses any non-stream response headers sent by the child. For example, WriteClient of data representing response headers is impossible to suppress, but structured headers sent using HSE_REQ_SEND_RESPONSE_HEADER, HSE_REQ_VECTOR_SEND, and HSE_REQ_SEND_CUSTOM_ERROR are suppressed. Absence of this flag allows the child's response headers to be a part of the response.

    HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR

    When a parent ISAPI, acting as a Wildcard Scriptmap Mapping sets this flag, it prevents the execution of the parent ISAPI for the remaining duration of the child request. In particular, if recursion of the child request occurs or the same parent ISAPI is otherwise triggered as a scriptmap from another virtual directory, setting this flag prevents the parent ISAPI from processing the request again.

    HSE_EXEC_URL_IGNORE_VALIDATION_AND_RANGE

    When this flag is present and pszChildHeaders is NULL, the following headers will be removed from the child URL's processing if they exist:

    • If-Match

    • If-None-Match

    • If-Modified-Since

    • If-Unmodified-Since

    • If-Range

    • Range

    If pszChildHeaders is not NULL, this flag has no effect.

    HSE_EXEC_URL_DISABLE_CUSTOM_ERROR

    When this flag is present, any entity body sent out as a part of a custom error will be suppressed. The headers of the custom error may be further suppressed with HSE_EXEC_URL_NO_HEADERS to allow the parent complete control of the response.

Requirements

Server: Requires or Windows Server 2003.

Product: IIS

Header: Declared in httpext.h.

See Also