452 lines
14 KiB
C
452 lines
14 KiB
C
/*++
|
|
|
|
Copyright (c) 1998-2001 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
http.h
|
|
|
|
Abstract:
|
|
|
|
Contains structures and declarations shared between
|
|
HTTP.SYS and HTTPAPI.DLL. Users of the httpapi should include
|
|
httpapi.h and not this file.
|
|
|
|
Author:
|
|
|
|
Keith Moore (keithmo) 10-Jun-1998
|
|
|
|
Revision History:
|
|
|
|
Chun Ye (chunye) 27-Sep-2000
|
|
|
|
Renamed UL_* to HTTP_*.
|
|
|
|
--*/
|
|
|
|
|
|
#ifndef _HTTP_H_
|
|
#define _HTTP_H_
|
|
|
|
|
|
#include <httpdef.h>
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif // __cplusplus
|
|
|
|
|
|
//
|
|
// Names of the object directory, devices, driver, and service.
|
|
//
|
|
|
|
#define HTTP_DIRECTORY_NAME L"\\Device\\Http"
|
|
#define HTTP_CONTROL_DEVICE_NAME L"\\Device\\Http\\Control"
|
|
#define HTTP_APP_POOL_DEVICE_NAME L"\\Device\\Http\\AppPool"
|
|
#define HTTP_FILTER_DEVICE_NAME L"\\Device\\Http\\Filter"
|
|
#define HTTP_DRIVER_NAME L"HTTP.SYS"
|
|
#define HTTP_SERVICE_NAME L"HTTP"
|
|
|
|
//
|
|
// Names of the filters.
|
|
//
|
|
#define HTTP_SSL_SERVER_FILTER_CHANNEL_NAME L"SSLFilterChannel"
|
|
#define HTTP_SSL_SERVER_FILTER_CHANNEL_NAME_LENGTH \
|
|
(sizeof(HTTP_SSL_SERVER_FILTER_CHANNEL_NAME)-sizeof(WCHAR))
|
|
|
|
#define HTTP_SSL_CLIENT_FILTER_CHANNEL_NAME L"SSLClientFilterChannel"
|
|
#define HTTP_SSL_CLIENT_FILTER_CHANNEL_NAME_LENGTH \
|
|
(sizeof(HTTP_SSL_CLIENT_FILTER_CHANNEL_NAME)-sizeof(WCHAR))
|
|
|
|
|
|
|
|
|
|
//
|
|
// The current interface version number. This version number must be
|
|
// updated after any significant changes to the interface (especially
|
|
// structure changes).
|
|
//
|
|
|
|
#define HTTP_INTERFACE_VERSION_MAJOR 0x0001
|
|
#define HTTP_INTERFACE_VERSION_MINOR 0x0000
|
|
|
|
|
|
//
|
|
// The name of the EA (Extended Attribute) passed to NtCreateFile(). This
|
|
// allows us to pass version information at the time the driver is opened,
|
|
// allowing UL.SYS to immediately fail open requests with invalid version
|
|
// numbers.
|
|
//
|
|
// N.B. The EA name (including the terminator) must be a multiple of eight
|
|
// to ensure natural alignment of the HTTP_OPEN_PACKET structure used as
|
|
// the EA value.
|
|
//
|
|
|
|
// 7654321076543210
|
|
#define HTTP_OPEN_PACKET_NAME "UlOpenPacket000"
|
|
#define HTTP_OPEN_PACKET_NAME_LENGTH (sizeof(HTTP_OPEN_PACKET_NAME) - 1)
|
|
C_ASSERT( ((HTTP_OPEN_PACKET_NAME_LENGTH + 1) & 7) == 0 );
|
|
|
|
|
|
//
|
|
// The following structure is used as the value for the EA named above.
|
|
//
|
|
|
|
typedef struct HTTP_OPEN_PACKET
|
|
{
|
|
USHORT MajorVersion;
|
|
USHORT MinorVersion;
|
|
|
|
} HTTP_OPEN_PACKET, *PHTTP_OPEN_PACKET;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_QUERY_CONTROL_CHANNEL and
|
|
// IOCTL_HTTP_SET_CONTROL_CHANNEL.
|
|
//
|
|
|
|
typedef struct _HTTP_CONTROL_CHANNEL_INFO
|
|
{
|
|
HTTP_CONTROL_CHANNEL_INFORMATION_CLASS InformationClass;
|
|
|
|
} HTTP_CONTROL_CHANNEL_INFO, *PHTTP_CONTROL_CHANNEL_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_CREATE_CONFIG_GROUP,
|
|
// IOCTL_HTTP_DELETE_CONFIG_GROUP, IOCTL_HTTP_QUERY_CONFIG_GROUP,
|
|
// and IOCTL_HTTP_SET_CONFIG_GROUP.
|
|
//
|
|
|
|
typedef struct _HTTP_CONFIG_GROUP_INFO
|
|
{
|
|
HTTP_CONFIG_GROUP_ID ConfigGroupId;
|
|
HTTP_CONFIG_GROUP_INFORMATION_CLASS InformationClass;
|
|
|
|
} HTTP_CONFIG_GROUP_INFO, *PHTTP_CONFIG_GROUP_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_ADD_URL_TO_CONFIG_GROUP and
|
|
// IOCTL_HTTP_REMOVE_URL_FROM_CONFIG_GROUP.
|
|
//
|
|
|
|
typedef struct _HTTP_CONFIG_GROUP_URL_INFO
|
|
{
|
|
HTTP_CONFIG_GROUP_ID ConfigGroupId;
|
|
HTTP_URL_CONTEXT UrlContext;
|
|
UNICODE_STRING FullyQualifiedUrl;
|
|
|
|
} HTTP_CONFIG_GROUP_URL_INFO, *PHTTP_CONFIG_GROUP_URL_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_REMOVE_ALL_URLS_FROM_CONFIG_GROUP.
|
|
//
|
|
|
|
typedef struct _HTTP_REMOVE_ALL_URLS_INFO
|
|
{
|
|
HTTP_CONFIG_GROUP_ID ConfigGroupId;
|
|
|
|
} HTTP_REMOVE_ALL_URLS_INFO, *PHTTP_REMOVE_ALL_URLS_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_CREATE_APP_POOL.
|
|
//
|
|
|
|
typedef struct _HTTP_CREATE_APP_POOL_INFO
|
|
{
|
|
UNICODE_STRING AppPoolName;
|
|
|
|
} HTTP_CREATE_APP_POOL_INFO, *PHTTP_CREATE_APP_POOL_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_QUERY_APP_POOL_INFORMATION and
|
|
// IOCTL_HTTP_SET_APP_POOL_INFORMATION.
|
|
//
|
|
|
|
typedef struct _HTTP_APP_POOL_INFO
|
|
{
|
|
HTTP_APP_POOL_INFORMATION_CLASS InformationClass;
|
|
|
|
} HTTP_APP_POOL_INFO, *PHTTP_APP_POOL_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_ADD_TRANSIENT_URL and
|
|
// IOCTL_HTTP_REMOVE_TRANSIENT_URL.
|
|
//
|
|
|
|
typedef struct _HTTP_TRANSIENT_URL_INFO
|
|
{
|
|
UNICODE_STRING FullyQualifiedUrl;
|
|
|
|
} HTTP_TRANSIENT_URL_INFO, *PHTTP_TRANSIENT_URL_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_RECEIVE_HTTP_REQUEST and
|
|
// IOCTL_HTTP_RECEIVE_ENTITY_BODY.
|
|
//
|
|
|
|
typedef struct _HTTP_RECEIVE_REQUEST_INFO
|
|
{
|
|
HTTP_REQUEST_ID RequestId;
|
|
ULONG Flags;
|
|
|
|
} HTTP_RECEIVE_REQUEST_INFO, *PHTTP_RECEIVE_REQUEST_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_SEND_HTTP_RESPONSE.
|
|
//
|
|
|
|
typedef struct _HTTP_SEND_HTTP_RESPONSE_INFO
|
|
{
|
|
PHTTP_RESPONSE pHttpResponse;
|
|
ULONG EntityChunkCount;
|
|
PHTTP_DATA_CHUNK pEntityChunks;
|
|
HTTP_CACHE_POLICY CachePolicy;
|
|
HTTP_REQUEST_ID RequestId;
|
|
ULONG Flags;
|
|
PHTTP_LOG_FIELDS_DATA pLogData;
|
|
|
|
} HTTP_SEND_HTTP_RESPONSE_INFO, *PHTTP_SEND_HTTP_RESPONSE_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_FLUSH_RESPONSE_CACHE.
|
|
//
|
|
|
|
typedef struct _HTTP_FLUSH_RESPONSE_CACHE_INFO
|
|
{
|
|
UNICODE_STRING FullyQualifiedUrl;
|
|
ULONG Flags;
|
|
|
|
} HTTP_FLUSH_RESPONSE_CACHE_INFO, *PHTTP_FLUSH_RESPONSE_CACHE_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_WAIT_FOR_DISCONNECT.
|
|
//
|
|
|
|
typedef struct _HTTP_WAIT_FOR_DISCONNECT_INFO
|
|
{
|
|
HTTP_CONNECTION_ID ConnectionId;
|
|
|
|
} HTTP_WAIT_FOR_DISCONNECT_INFO, *PHTTP_WAIT_FOR_DISCONNECT_INFO;
|
|
|
|
|
|
//
|
|
// Structures for IOCTL_HTTP_FILTER_RECEIVE_CLIENT_CERT
|
|
//
|
|
|
|
typedef struct _HTTP_FILTER_RECEIVE_CLIENT_CERT_INFO
|
|
{
|
|
HTTP_CONNECTION_ID ConnectionId;
|
|
ULONG Flags;
|
|
|
|
} HTTP_FILTER_RECEIVE_CLIENT_CERT_INFO, *PHTTP_FILTER_RECEIVE_CLIENT_CERT_INFO;
|
|
|
|
|
|
//
|
|
// HTTP IOCTL code definitions.
|
|
//
|
|
// N.B. To ensure the efficient of the code generated by HTTP's
|
|
// IOCTL dispatcher, these IOCTL codes should be contiguous
|
|
// (no gaps).
|
|
//
|
|
// N.B. If new IOCTLs are added here, update the lookup table in
|
|
// devctrl.c.
|
|
//
|
|
|
|
#define _HTTP_CTL_CODE(request, method, access) \
|
|
CTL_CODE( FILE_DEVICE_NETWORK, request, method, access )
|
|
|
|
#define _HTTP_REQUEST(ioctl) \
|
|
((((ULONG)(ioctl)) >> 2) & 0x03FF)
|
|
|
|
|
|
#define HTTP_QUERY_CONTROL_CHANNEL 0
|
|
#define HTTP_SET_CONTROL_CHANNEL 1
|
|
#define HTTP_CREATE_CONFIG_GROUP 2
|
|
#define HTTP_DELETE_CONFIG_GROUP 3
|
|
#define HTTP_QUERY_CONFIG_GROUP 4
|
|
#define HTTP_SET_CONFIG_GROUP 5
|
|
#define HTTP_ADD_URL_TO_CONFIG_GROUP 6
|
|
#define HTTP_REMOVE_URL_FROM_CONFIG_GROUP 7
|
|
#define HTTP_QUERY_APP_POOL_INFORMATION 8
|
|
#define HTTP_SET_APP_POOL_INFORMATION 9
|
|
#define HTTP_RECEIVE_HTTP_REQUEST 10
|
|
#define HTTP_RECEIVE_ENTITY_BODY 11
|
|
#define HTTP_SEND_HTTP_RESPONSE 12
|
|
#define HTTP_SEND_ENTITY_BODY 13
|
|
#define HTTP_FLUSH_RESPONSE_CACHE 14
|
|
#define HTTP_WAIT_FOR_DEMAND_START 15
|
|
#define HTTP_WAIT_FOR_DISCONNECT 16
|
|
#define HTTP_REMOVE_ALL_URLS_FROM_CONFIG_GROUP 17
|
|
#define HTTP_ADD_TRANSIENT_URL 18
|
|
#define HTTP_REMOVE_TRANSIENT_URL 19
|
|
#define HTTP_FILTER_ACCEPT 20
|
|
#define HTTP_FILTER_CLOSE 21
|
|
#define HTTP_FILTER_RAW_READ 22
|
|
#define HTTP_FILTER_RAW_WRITE 23
|
|
#define HTTP_FILTER_APP_READ 24
|
|
#define HTTP_FILTER_APP_WRITE 25
|
|
#define HTTP_FILTER_RECEIVE_CLIENT_CERT 26
|
|
#define HTTP_GET_COUNTERS 27
|
|
|
|
#define HTTP_NUM_IOCTLS 28
|
|
|
|
|
|
#define IOCTL_HTTP_QUERY_CONTROL_CHANNEL \
|
|
_HTTP_CTL_CODE( HTTP_QUERY_CONTROL_CHANNEL, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_SET_CONTROL_CHANNEL \
|
|
_HTTP_CTL_CODE( HTTP_SET_CONTROL_CHANNEL, \
|
|
METHOD_IN_DIRECT, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_CREATE_CONFIG_GROUP \
|
|
_HTTP_CTL_CODE( HTTP_CREATE_CONFIG_GROUP, \
|
|
METHOD_BUFFERED, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_DELETE_CONFIG_GROUP \
|
|
_HTTP_CTL_CODE( HTTP_DELETE_CONFIG_GROUP, \
|
|
METHOD_BUFFERED, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_QUERY_CONFIG_GROUP \
|
|
_HTTP_CTL_CODE( HTTP_QUERY_CONFIG_GROUP, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_SET_CONFIG_GROUP \
|
|
_HTTP_CTL_CODE( HTTP_SET_CONFIG_GROUP, \
|
|
METHOD_IN_DIRECT, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_ADD_URL_TO_CONFIG_GROUP \
|
|
_HTTP_CTL_CODE( HTTP_ADD_URL_TO_CONFIG_GROUP, \
|
|
METHOD_BUFFERED, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_REMOVE_URL_FROM_CONFIG_GROUP \
|
|
_HTTP_CTL_CODE( HTTP_REMOVE_URL_FROM_CONFIG_GROUP, \
|
|
METHOD_BUFFERED, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_QUERY_APP_POOL_INFORMATION \
|
|
_HTTP_CTL_CODE( HTTP_QUERY_APP_POOL_INFORMATION, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_SET_APP_POOL_INFORMATION \
|
|
_HTTP_CTL_CODE( HTTP_SET_APP_POOL_INFORMATION, \
|
|
METHOD_IN_DIRECT, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_RECEIVE_HTTP_REQUEST \
|
|
_HTTP_CTL_CODE( HTTP_RECEIVE_HTTP_REQUEST, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_RECEIVE_ENTITY_BODY \
|
|
_HTTP_CTL_CODE( HTTP_RECEIVE_ENTITY_BODY, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_SEND_HTTP_RESPONSE \
|
|
_HTTP_CTL_CODE( HTTP_SEND_HTTP_RESPONSE, \
|
|
METHOD_NEITHER, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_SEND_ENTITY_BODY \
|
|
_HTTP_CTL_CODE( HTTP_SEND_ENTITY_BODY, \
|
|
METHOD_NEITHER, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_FLUSH_RESPONSE_CACHE \
|
|
_HTTP_CTL_CODE( HTTP_FLUSH_RESPONSE_CACHE, \
|
|
METHOD_BUFFERED, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_WAIT_FOR_DEMAND_START \
|
|
_HTTP_CTL_CODE( HTTP_WAIT_FOR_DEMAND_START, \
|
|
METHOD_BUFFERED, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_WAIT_FOR_DISCONNECT \
|
|
_HTTP_CTL_CODE( HTTP_WAIT_FOR_DISCONNECT, \
|
|
METHOD_BUFFERED, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_REMOVE_ALL_URLS_FROM_CONFIG_GROUP \
|
|
_HTTP_CTL_CODE( HTTP_REMOVE_ALL_URLS_FROM_CONFIG_GROUP, \
|
|
METHOD_BUFFERED, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_ADD_TRANSIENT_URL \
|
|
_HTTP_CTL_CODE( HTTP_ADD_TRANSIENT_URL, \
|
|
METHOD_BUFFERED, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_REMOVE_TRANSIENT_URL \
|
|
_HTTP_CTL_CODE( HTTP_REMOVE_TRANSIENT_URL, \
|
|
METHOD_BUFFERED, \
|
|
FILE_WRITE_ACCESS )
|
|
|
|
#define IOCTL_HTTP_FILTER_ACCEPT \
|
|
_HTTP_CTL_CODE( HTTP_FILTER_ACCEPT, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_FILTER_CLOSE \
|
|
_HTTP_CTL_CODE( HTTP_FILTER_CLOSE, \
|
|
METHOD_BUFFERED, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_FILTER_RAW_READ \
|
|
_HTTP_CTL_CODE( HTTP_FILTER_RAW_READ, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_FILTER_RAW_WRITE \
|
|
_HTTP_CTL_CODE( HTTP_FILTER_RAW_WRITE, \
|
|
METHOD_IN_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_FILTER_APP_READ \
|
|
_HTTP_CTL_CODE( HTTP_FILTER_APP_READ, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_FILTER_APP_WRITE \
|
|
_HTTP_CTL_CODE( HTTP_FILTER_APP_WRITE, \
|
|
METHOD_IN_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_FILTER_RECEIVE_CLIENT_CERT \
|
|
_HTTP_CTL_CODE( HTTP_FILTER_RECEIVE_CLIENT_CERT, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#define IOCTL_HTTP_GET_COUNTERS \
|
|
_HTTP_CTL_CODE( HTTP_GET_COUNTERS, \
|
|
METHOD_OUT_DIRECT, \
|
|
FILE_READ_ACCESS )
|
|
|
|
#ifdef __cplusplus
|
|
} // extern "C"
|
|
#endif // __cplusplus
|
|
|
|
|
|
#endif // _HTTP_H_
|
|
|