master
1/**
2 * This file has no copyright assigned and is placed in the Public Domain.
3 * This file is part of the mingw-w64 runtime package.
4 * No warranty is given; refer to the file DISCLAIMER.PD within this package.
5 */
6#ifndef __HTTP_H__
7#define __HTTP_H__
8
9#include <winsock2.h>
10#include <ws2tcpip.h>
11
12#define SECURITY_WIN32
13#include <sspi.h>
14
15#ifdef __cplusplus
16extern "C" {
17#endif
18
19#define HTTP_INITIALIZE_SERVER 0x00000001
20#define HTTP_INITIALIZE_CONFIG 0x00000002
21
22#define HTTP_RECEIVE_REQUEST_FLAG_COPY_BODY 0x00000001
23#define HTTP_RECEIVE_REQUEST_ENTITY_BODY_FLAG_FILL_BUFFER 0x00000001
24
25#define HTTP_SEND_RESPONSE_FLAG_DISCONNECT 0x00000001
26#define HTTP_SEND_RESPONSE_FLAG_MORE_DATA 0x00000002
27#define HTTP_SEND_RESPONSE_FLAG_BUFFER_DATA 0x00000004
28
29#define HTTP_FLUSH_RESPONSE_FLAG_RECURSIVE 0x00000001
30
31 typedef ULONGLONG HTTP_OPAQUE_ID,*PHTTP_OPAQUE_ID;
32
33 typedef HTTP_OPAQUE_ID HTTP_REQUEST_ID,*PHTTP_REQUEST_ID;
34 typedef HTTP_OPAQUE_ID HTTP_CONNECTION_ID,*PHTTP_CONNECTION_ID;
35 typedef HTTP_OPAQUE_ID HTTP_RAW_CONNECTION_ID,*PHTTP_RAW_CONNECTION_ID;
36 typedef HTTP_OPAQUE_ID HTTP_URL_GROUP_ID, *PHTTP_URL_GROUP_ID;
37 typedef HTTP_OPAQUE_ID HTTP_SERVER_SESSION_ID, *PHTTP_SERVER_SESSION_ID;
38
39#define HTTP_NULL_ID (0ull)
40#define HTTP_IS_NULL_ID(pid) (HTTP_NULL_ID==*(pid))
41#define HTTP_SET_NULL_ID(pid) (*(pid) = HTTP_NULL_ID)
42
43#define HTTP_BYTE_RANGE_TO_EOF ((ULONGLONG)-1)
44
45 typedef struct _HTTP_BYTE_RANGE {
46 ULARGE_INTEGER StartingOffset;
47 ULARGE_INTEGER Length;
48 } HTTP_BYTE_RANGE,*PHTTP_BYTE_RANGE;
49
50 typedef struct _HTTP_VERSION {
51 USHORT MajorVersion;
52 USHORT MinorVersion;
53 } HTTP_VERSION,*PHTTP_VERSION;
54
55#define HTTP_VERSION_UNKNOWN { 0,0 }
56#define HTTP_VERSION_0_9 { 0,9 }
57#define HTTP_VERSION_1_0 { 1,0 }
58#define HTTP_VERSION_1_1 { 1,1 }
59
60#define HTTP_SET_VERSION(version,major,minor) do { (version).MajorVersion = (major); (version).MinorVersion = (minor); } while (0,0)
61#define HTTP_EQUAL_VERSION(version,major,minor) ((version).MajorVersion==(major) && (version).MinorVersion==(minor))
62#define HTTP_GREATER_VERSION(version,major,minor) ((version).MajorVersion > (major) || ((version).MajorVersion==(major) && (version).MinorVersion > (minor)))
63#define HTTP_LESS_VERSION(version,major,minor) ((version).MajorVersion < (major) || ((version).MajorVersion==(major) && (version).MinorVersion < (minor)))
64#define HTTP_NOT_EQUAL_VERSION(version,major,minor) (!HTTP_EQUAL_VERSION(version,major,minor))
65#define HTTP_GREATER_EQUAL_VERSION(version,major,minor) (!HTTP_LESS_VERSION(version,major,minor))
66#define HTTP_LESS_EQUAL_VERSION(version,major,minor) (!HTTP_GREATER_VERSION(version,major,minor))
67
68 typedef enum _HTTP_VERB {
69 HttpVerbUnparsed = 0,
70 HttpVerbUnknown,HttpVerbInvalid,HttpVerbOPTIONS,HttpVerbGET,HttpVerbHEAD,HttpVerbPOST,HttpVerbPUT,HttpVerbDELETE,
71 HttpVerbTRACE,HttpVerbCONNECT,HttpVerbTRACK,HttpVerbMOVE,HttpVerbCOPY,HttpVerbPROPFIND,HttpVerbPROPPATCH,HttpVerbMKCOL,HttpVerbLOCK,
72 HttpVerbUNLOCK,HttpVerbSEARCH,HttpVerbMaximum
73 } HTTP_VERB,*PHTTP_VERB;
74
75 typedef enum _HTTP_HEADER_ID {
76 HttpHeaderCacheControl = 0,HttpHeaderConnection = 1,HttpHeaderDate = 2,HttpHeaderKeepAlive = 3,HttpHeaderPragma = 4,HttpHeaderTrailer = 5,
77 HttpHeaderTransferEncoding = 6,HttpHeaderUpgrade = 7,HttpHeaderVia = 8,HttpHeaderWarning = 9,HttpHeaderAllow = 10,HttpHeaderContentLength = 11,
78 HttpHeaderContentType = 12,HttpHeaderContentEncoding = 13,HttpHeaderContentLanguage = 14,HttpHeaderContentLocation = 15,HttpHeaderContentMd5 = 16,
79 HttpHeaderContentRange = 17,HttpHeaderExpires = 18,HttpHeaderLastModified = 19,HttpHeaderAccept = 20,HttpHeaderAcceptCharset = 21,
80 HttpHeaderAcceptEncoding = 22,HttpHeaderAcceptLanguage = 23,HttpHeaderAuthorization = 24,HttpHeaderCookie = 25,HttpHeaderExpect = 26,
81 HttpHeaderFrom = 27,HttpHeaderHost = 28,HttpHeaderIfMatch = 29,HttpHeaderIfModifiedSince = 30,HttpHeaderIfNoneMatch = 31,HttpHeaderIfRange = 32,
82 HttpHeaderIfUnmodifiedSince = 33,HttpHeaderMaxForwards = 34,HttpHeaderProxyAuthorization = 35,HttpHeaderReferer = 36,HttpHeaderRange = 37,
83 HttpHeaderTe = 38,HttpHeaderTranslate = 39,HttpHeaderUserAgent = 40,HttpHeaderRequestMaximum = 41,HttpHeaderAcceptRanges = 20,HttpHeaderAge = 21,
84 HttpHeaderEtag = 22,HttpHeaderLocation = 23,HttpHeaderProxyAuthenticate = 24,HttpHeaderRetryAfter = 25,HttpHeaderServer = 26,
85 HttpHeaderSetCookie = 27,HttpHeaderVary = 28,HttpHeaderWwwAuthenticate = 29,HttpHeaderResponseMaximum = 30,HttpHeaderMaximum = 41
86 } HTTP_HEADER_ID,*PHTTP_HEADER_ID;
87
88 typedef struct _HTTP_KNOWN_HEADER {
89 USHORT RawValueLength;
90 PCSTR pRawValue;
91 } HTTP_KNOWN_HEADER,*PHTTP_KNOWN_HEADER;
92
93 typedef struct _HTTP_UNKNOWN_HEADER {
94 USHORT NameLength;
95 USHORT RawValueLength;
96 PCSTR pName;
97 PCSTR pRawValue;
98 } HTTP_UNKNOWN_HEADER,*PHTTP_UNKNOWN_HEADER;
99
100 typedef enum _HTTP_DATA_CHUNK_TYPE {
101 HttpDataChunkFromMemory = 0,
102 HttpDataChunkFromFileHandle,
103 HttpDataChunkFromFragmentCache,
104 HttpDataChunkFromFragmentCacheEx,
105 HttpDataChunkMaximum
106 } HTTP_DATA_CHUNK_TYPE,*PHTTP_DATA_CHUNK_TYPE;
107
108 typedef struct _HTTP_DATA_CHUNK {
109 HTTP_DATA_CHUNK_TYPE DataChunkType;
110 __C89_NAMELESS union {
111 struct {
112 PVOID pBuffer;
113 ULONG BufferLength;
114 } FromMemory;
115 struct {
116 HTTP_BYTE_RANGE ByteRange;
117 HANDLE FileHandle;
118 } FromFileHandle;
119 struct {
120 USHORT FragmentNameLength;
121 PCWSTR pFragmentName;
122 } FromFragmentCache;
123 };
124 } HTTP_DATA_CHUNK,*PHTTP_DATA_CHUNK;
125
126 typedef struct _HTTP_REQUEST_HEADERS {
127 USHORT UnknownHeaderCount;
128 PHTTP_UNKNOWN_HEADER pUnknownHeaders;
129 USHORT TrailerCount;
130 PHTTP_UNKNOWN_HEADER pTrailers;
131 HTTP_KNOWN_HEADER KnownHeaders[HttpHeaderRequestMaximum];
132 } HTTP_REQUEST_HEADERS,*PHTTP_REQUEST_HEADERS;
133
134 typedef struct _HTTP_RESPONSE_HEADERS {
135 USHORT UnknownHeaderCount;
136 PHTTP_UNKNOWN_HEADER pUnknownHeaders;
137 USHORT TrailerCount;
138 PHTTP_UNKNOWN_HEADER pTrailers;
139 HTTP_KNOWN_HEADER KnownHeaders[HttpHeaderResponseMaximum];
140 } HTTP_RESPONSE_HEADERS,*PHTTP_RESPONSE_HEADERS;
141
142 typedef struct _HTTP_TRANSPORT_ADDRESS {
143 PSOCKADDR pRemoteAddress;
144 PSOCKADDR pLocalAddress;
145 } HTTP_TRANSPORT_ADDRESS,*PHTTP_TRANSPORT_ADDRESS;
146
147 typedef struct _HTTP_COOKED_URL {
148 USHORT FullUrlLength;
149 USHORT HostLength;
150 USHORT AbsPathLength;
151 USHORT QueryStringLength;
152 PCWSTR pFullUrl;
153 PCWSTR pHost;
154 PCWSTR pAbsPath;
155 PCWSTR pQueryString;
156 } HTTP_COOKED_URL,*PHTTP_COOKED_URL;
157
158 typedef ULONGLONG HTTP_URL_CONTEXT;
159
160 typedef struct _HTTP_SSL_CLIENT_CERT_INFO {
161 ULONG CertFlags;
162 ULONG CertEncodedSize;
163 PUCHAR pCertEncoded;
164 HANDLE Token;
165 BOOLEAN CertDeniedByMapper;
166 } HTTP_SSL_CLIENT_CERT_INFO,*PHTTP_SSL_CLIENT_CERT_INFO;
167
168 typedef struct _HTTP_SSL_INFO {
169 USHORT ServerCertKeySize;
170 USHORT ConnectionKeySize;
171 ULONG ServerCertIssuerSize;
172 ULONG ServerCertSubjectSize;
173 PCSTR pServerCertIssuer;
174 PCSTR pServerCertSubject;
175 PHTTP_SSL_CLIENT_CERT_INFO pClientCertInfo;
176 ULONG SslClientCertNegotiated;
177 } HTTP_SSL_INFO,*PHTTP_SSL_INFO;
178
179 typedef struct _HTTP_REQUEST_V1 {
180 ULONG Flags;
181 HTTP_CONNECTION_ID ConnectionId;
182 HTTP_REQUEST_ID RequestId;
183 HTTP_URL_CONTEXT UrlContext;
184 HTTP_VERSION Version;
185 HTTP_VERB Verb;
186 USHORT UnknownVerbLength;
187 USHORT RawUrlLength;
188 PCSTR pUnknownVerb;
189 PCSTR pRawUrl;
190 HTTP_COOKED_URL CookedUrl;
191 HTTP_TRANSPORT_ADDRESS Address;
192 HTTP_REQUEST_HEADERS Headers;
193 ULONGLONG BytesReceived;
194 USHORT EntityChunkCount;
195 PHTTP_DATA_CHUNK pEntityChunks;
196 HTTP_RAW_CONNECTION_ID RawConnectionId;
197 PHTTP_SSL_INFO pSslInfo;
198 } HTTP_REQUEST_V1, *PHTTP_REQUEST_V1;
199
200 typedef enum _HTTP_REQUEST_INFO_TYPE {
201 HttpRequestInfoTypeAuth = 0
202 } HTTP_REQUEST_INFO_TYPE, *PHTTP_REQUEST_INFO_TYPE;
203
204 typedef struct _HTTP_REQUEST_INFO {
205 HTTP_REQUEST_INFO_TYPE InfoType;
206 ULONG InfoLength;
207 PVOID pInfo;
208 } HTTP_REQUEST_INFO, *PHTTP_REQUEST_INFO;
209
210#ifdef __cplusplus
211 typedef struct _HTTP_REQUEST_V2 : HTTP_REQUEST_V1 {
212 USHORT RequestInfoCount;
213 PHTTP_REQUEST_INFO pRequestInfo;
214 } HTTP_REQUEST_V2, *PHTTP_REQUEST_V2;
215#else
216 typedef struct _HTTP_REQUEST_V2 {
217 /* struct HTTP_REQUEST_V1; */
218 __C89_NAMELESS struct {
219 ULONG Flags;
220 HTTP_CONNECTION_ID ConnectionId;
221 HTTP_REQUEST_ID RequestId;
222 HTTP_URL_CONTEXT UrlContext;
223 HTTP_VERSION Version;
224 HTTP_VERB Verb;
225 USHORT UnknownVerbLength;
226 USHORT RawUrlLength;
227 PCSTR pUnknownVerb;
228 PCSTR pRawUrl;
229 HTTP_COOKED_URL CookedUrl;
230 HTTP_TRANSPORT_ADDRESS Address;
231 HTTP_REQUEST_HEADERS Headers;
232 ULONGLONG BytesReceived;
233 USHORT EntityChunkCount;
234 PHTTP_DATA_CHUNK pEntityChunks;
235 HTTP_RAW_CONNECTION_ID RawConnectionId;
236 PHTTP_SSL_INFO pSslInfo;
237 };
238 USHORT RequestInfoCount;
239 PHTTP_REQUEST_INFO pRequestInfo;
240 } HTTP_REQUEST_V2, *PHTTP_REQUEST_V2;
241#endif
242
243#if (_WIN32_WINNT >= 0x0600)
244 typedef HTTP_REQUEST_V2 HTTP_REQUEST, *PHTTP_REQUEST;
245#else
246 typedef HTTP_REQUEST_V1 HTTP_REQUEST, *PHTTP_REQUEST;
247#endif
248
249#define HTTP_REQUEST_FLAG_MORE_ENTITY_BODY_EXISTS 0x00000001
250
251 typedef struct _HTTP_RESPONSE_V1 {
252 ULONG Flags;
253 HTTP_VERSION Version;
254 USHORT StatusCode;
255 USHORT ReasonLength;
256 PCSTR pReason;
257 HTTP_RESPONSE_HEADERS Headers;
258 USHORT EntityChunkCount;
259 PHTTP_DATA_CHUNK pEntityChunks;
260 } HTTP_RESPONSE_V1,*PHTTP_RESPONSE_V1;
261
262 typedef enum _HTTP_RESPONSE_INFO_TYPE {
263 HttpResponseInfoTypeMultipleKnownHeaders = 0,
264 HttpResponseInfoTypeAuthenticationProperty,
265 HttpResponseInfoTypeQosProperty,
266 HttpResponseInfoTypeChannelBind
267 } HTTP_RESPONSE_INFO_TYPE, *PHTTP_RESPONSE_INFO_TYPE;
268
269 typedef struct _HTTP_RESPONSE_INFO {
270 HTTP_RESPONSE_INFO_TYPE Type;
271 ULONG Length;
272 PVOID pInfo;
273 } HTTP_RESPONSE_INFO, *PHTTP_RESPONSE_INFO;
274
275#ifdef __cplusplus
276 typedef struct _HTTP_RESPONSE_V2 : HTTP_RESPONSE_V1 {
277 USHORT ResponseInfoCount;
278 PHTTP_RESPONSE_INFO pResponseInfo;
279 } HTTP_RESPONSE_V2, *PHTTP_RESPONSE_V2;
280#else
281 typedef struct _HTTP_RESPONSE_V2 {
282 /* struct HTTP_RESPONSE_V1; */
283 __C89_NAMELESS struct {
284 ULONG Flags;
285 HTTP_VERSION Version;
286 USHORT StatusCode;
287 USHORT ReasonLength;
288 PCSTR pReason;
289 HTTP_RESPONSE_HEADERS Headers;
290 USHORT EntityChunkCount;
291 PHTTP_DATA_CHUNK pEntityChunks;
292 };
293 USHORT ResponseInfoCount;
294 PHTTP_RESPONSE_INFO pResponseInfo;
295 } HTTP_RESPONSE_V2, *PHTTP_RESPONSE_V2;
296#endif
297
298#if (_WIN32_WINNT >= 0x0600)
299 typedef HTTP_RESPONSE_V2 HTTP_RESPONSE, *PHTTP_RESPONSE;
300#else
301 typedef HTTP_RESPONSE_V1 HTTP_RESPONSE, *PHTTP_RESPONSE;
302#endif /* _WIN32_WINNT >= 0x0600 */
303
304 typedef enum _HTTP_CACHE_POLICY_TYPE {
305 HttpCachePolicyNocache = 0,
306 HttpCachePolicyUserInvalidates,
307 HttpCachePolicyTimeToLive,
308 HttpCachePolicyMaximum
309 } HTTP_CACHE_POLICY_TYPE,*PHTTP_CACHE_POLICY_TYPE;
310
311 typedef struct _HTTP_CACHE_POLICY {
312 HTTP_CACHE_POLICY_TYPE Policy;
313 ULONG SecondsToLive;
314 } HTTP_CACHE_POLICY, *PHTTP_CACHE_POLICY;
315
316 typedef enum _HTTP_SERVICE_CONFIG_ID {
317 HttpServiceConfigIPListenList = 0,
318 HttpServiceConfigSSLCertInfo,
319 HttpServiceConfigUrlAclInfo,
320 HttpServiceConfigMax
321 } HTTP_SERVICE_CONFIG_ID, *PHTTP_SERVICE_CONFIG_ID;
322
323 typedef enum _HTTP_SERVICE_CONFIG_QUERY_TYPE {
324 HttpServiceConfigQueryExact = 0,
325 HttpServiceConfigQueryNext,
326 HttpServiceConfigQueryMax
327 } HTTP_SERVICE_CONFIG_QUERY_TYPE,*PHTTP_SERVICE_CONFIG_QUERY_TYPE;
328
329 typedef struct _HTTP_SERVICE_CONFIG_SSL_KEY {
330 PSOCKADDR pIpPort;
331 } HTTP_SERVICE_CONFIG_SSL_KEY,*PHTTP_SERVICE_CONFIG_SSL_KEY;
332
333 typedef struct _HTTP_SERVICE_CONFIG_SSL_PARAM {
334 ULONG SslHashLength;
335 PVOID pSslHash;
336 GUID AppId;
337 PWSTR pSslCertStoreName;
338 DWORD DefaultCertCheckMode;
339 DWORD DefaultRevocationFreshnessTime;
340 DWORD DefaultRevocationUrlRetrievalTimeout;
341 PWSTR pDefaultSslCtlIdentifier;
342 PWSTR pDefaultSslCtlStoreName;
343 DWORD DefaultFlags;
344 } HTTP_SERVICE_CONFIG_SSL_PARAM,*PHTTP_SERVICE_CONFIG_SSL_PARAM;
345
346#define HTTP_SERVICE_CONFIG_SSL_FLAG_USE_DS_MAPPER 0x00000001
347#define HTTP_SERVICE_CONFIG_SSL_FLAG_NEGOTIATE_CLIENT_CERT 0x00000002
348#define HTTP_SERVICE_CONFIG_SSL_FLAG_NO_RAW_FILTER 0x00000004
349
350 typedef struct _HTTP_SERVICE_CONFIG_SSL_SET {
351 HTTP_SERVICE_CONFIG_SSL_KEY KeyDesc;
352 HTTP_SERVICE_CONFIG_SSL_PARAM ParamDesc;
353 } HTTP_SERVICE_CONFIG_SSL_SET,*PHTTP_SERVICE_CONFIG_SSL_SET;
354
355 typedef struct _HTTP_SERVICE_CONFIG_SSL_QUERY {
356 HTTP_SERVICE_CONFIG_QUERY_TYPE QueryDesc;
357 HTTP_SERVICE_CONFIG_SSL_KEY KeyDesc;
358 DWORD dwToken;
359 } HTTP_SERVICE_CONFIG_SSL_QUERY,*PHTTP_SERVICE_CONFIG_SSL_QUERY;
360
361 typedef struct _HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM {
362 USHORT AddrLength;
363 PSOCKADDR pAddress;
364 } HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM,*PHTTP_SERVICE_CONFIG_IP_LISTEN_PARAM;
365
366 typedef struct _HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY {
367 ULONG AddrCount;
368 SOCKADDR_STORAGE AddrList[ANYSIZE_ARRAY];
369 } HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY,*PHTTP_SERVICE_CONFIG_IP_LISTEN_QUERY;
370
371 typedef struct _HTTP_SERVICE_CONFIG_URLACL_KEY {
372 PWSTR pUrlPrefix;
373 } HTTP_SERVICE_CONFIG_URLACL_KEY,*PHTTP_SERVICE_CONFIG_URLACL_KEY;
374
375 typedef struct _HTTP_SERVICE_CONFIG_URLACL_PARAM {
376 PWSTR pStringSecurityDescriptor;
377 } HTTP_SERVICE_CONFIG_URLACL_PARAM,*PHTTP_SERVICE_CONFIG_URLACL_PARAM;
378
379 typedef struct _HTTP_SERVICE_CONFIG_URLACL_SET {
380 HTTP_SERVICE_CONFIG_URLACL_KEY KeyDesc;
381 HTTP_SERVICE_CONFIG_URLACL_PARAM ParamDesc;
382 } HTTP_SERVICE_CONFIG_URLACL_SET,*PHTTP_SERVICE_CONFIG_URLACL_SET;
383
384 typedef struct _HTTP_SERVICE_CONFIG_URLACL_QUERY {
385 HTTP_SERVICE_CONFIG_QUERY_TYPE QueryDesc;
386 HTTP_SERVICE_CONFIG_URLACL_KEY KeyDesc;
387 DWORD dwToken;
388 } HTTP_SERVICE_CONFIG_URLACL_QUERY,*PHTTP_SERVICE_CONFIG_URLACL_QUERY;
389
390#if !defined(HTTPAPI_LINKAGE)
391#ifdef HTTPAPI_LINKAGE_EXPORT
392#define DECLSPEC_EXPORT __declspec(dllexport)
393#define HTTPAPI_LINKAGE DECLSPEC_EXPORT
394#else
395#define HTTPAPI_LINKAGE DECLSPEC_IMPORT
396#endif
397#endif
398
399 typedef struct _HTTPAPI_VERSION {
400 USHORT HttpApiMajorVersion;
401 USHORT HttpApiMinorVersion;
402 } HTTPAPI_VERSION,*PHTTPAPI_VERSION;
403
404#define HTTPAPI_VERSION_1 {1,0}
405
406 HTTPAPI_LINKAGE ULONG WINAPI HttpInitialize(HTTPAPI_VERSION Version,ULONG Flags,PVOID pReserved);
407 HTTPAPI_LINKAGE ULONG WINAPI HttpTerminate(ULONG Flags,PVOID pReserved);
408 HTTPAPI_LINKAGE ULONG WINAPI HttpCreateHttpHandle(PHANDLE pReqQueueHandle,ULONG Options);
409 HTTPAPI_LINKAGE ULONG WINAPI HttpReceiveClientCertificate(HANDLE ReqQueueHandle,HTTP_CONNECTION_ID ConnectionId,ULONG Flags,PHTTP_SSL_CLIENT_CERT_INFO pSslClientCertInfo,ULONG SslClientCertInfoSize,PULONG pBytesReceived,LPOVERLAPPED pOverlapped);
410 HTTPAPI_LINKAGE ULONG WINAPI HttpAddUrl(HANDLE ReqQueueHandle,PCWSTR pUrlPrefix,PVOID pReserved);
411 HTTPAPI_LINKAGE ULONG WINAPI HttpRemoveUrl(HANDLE ReqQueueHandle,PCWSTR pUrlPrefix);
412 HTTPAPI_LINKAGE ULONG WINAPI HttpReceiveHttpRequest(HANDLE ReqQueueHandle,HTTP_REQUEST_ID RequestId,ULONG Flags,PHTTP_REQUEST pRequestBuffer,ULONG RequestBufferLength,PULONG pBytesReceived,LPOVERLAPPED pOverlapped);
413 HTTPAPI_LINKAGE ULONG WINAPI HttpReceiveRequestEntityBody(HANDLE ReqQueueHandle,HTTP_REQUEST_ID RequestId,ULONG Flags,PVOID pBuffer,ULONG BufferLength,PULONG pBytesReceived,LPOVERLAPPED pOverlapped);
414 HTTPAPI_LINKAGE ULONG WINAPI HttpSendHttpResponse(HANDLE ReqQueueHandle,HTTP_REQUEST_ID RequestId,ULONG Flags,PHTTP_RESPONSE pHttpResponse,PVOID pReserved1,PULONG pBytesSent,PVOID pReserved2,ULONG Reserved3,LPOVERLAPPED pOverlapped,PVOID pReserved4);
415 HTTPAPI_LINKAGE ULONG WINAPI HttpSendResponseEntityBody(HANDLE ReqQueueHandle,HTTP_REQUEST_ID RequestId,ULONG Flags,USHORT EntityChunkCount,PHTTP_DATA_CHUNK pEntityChunks,PULONG pBytesSent,PVOID pReserved1,ULONG Reserved2,LPOVERLAPPED pOverlapped,PVOID pReserved3);
416 HTTPAPI_LINKAGE ULONG WINAPI HttpWaitForDisconnect(HANDLE ReqQueueHandle,HTTP_CONNECTION_ID ConnectionId,LPOVERLAPPED pOverlapped);
417 HTTPAPI_LINKAGE ULONG WINAPI HttpFlushResponseCache(HANDLE ReqQueueHandle,PCWSTR pUrlPrefix,ULONG Flags,LPOVERLAPPED pOverlapped);
418 HTTPAPI_LINKAGE ULONG WINAPI HttpAddFragmentToCache(HANDLE ReqQueueHandle,PCWSTR pUrlPrefix,PHTTP_DATA_CHUNK pDataChunk,PHTTP_CACHE_POLICY pCachePolicy,LPOVERLAPPED pOverlapped);
419 HTTPAPI_LINKAGE ULONG WINAPI HttpReadFragmentFromCache(HANDLE ReqQueueHandle,PCWSTR pUrlPrefix,PHTTP_BYTE_RANGE pByteRange,PVOID pBuffer,ULONG BufferLength,PULONG pBytesRead,LPOVERLAPPED pOverlapped);
420 HTTPAPI_LINKAGE ULONG WINAPI HttpSetServiceConfiguration(HANDLE ServiceHandle,HTTP_SERVICE_CONFIG_ID ConfigId,PVOID pConfigInformation,ULONG ConfigInformationLength,LPOVERLAPPED pOverlapped);
421 HTTPAPI_LINKAGE ULONG WINAPI HttpDeleteServiceConfiguration(HANDLE ServiceHandle,HTTP_SERVICE_CONFIG_ID ConfigId,PVOID pConfigInformation,ULONG ConfigInformationLength,LPOVERLAPPED pOverlapped);
422 HTTPAPI_LINKAGE ULONG WINAPI HttpQueryServiceConfiguration(HANDLE ServiceHandle,HTTP_SERVICE_CONFIG_ID ConfigId,PVOID pInputConfigInformation,ULONG InputConfigInformationLength,PVOID pOutputConfigInformation,ULONG OutputConfigInformationLength,PULONG pReturnLength,LPOVERLAPPED pOverlapped);
423
424#if (_WIN32_WINNT >= 0x0600)
425#define HTTP_VERSION_2_0 { 2, 0 }
426#define HTTPAPI_VERSION_2 { 2, 0 }
427
428 typedef enum _HTTP_503_RESPONSE_VERBOSITY {
429 Http503ResponseVerbosityBasic = 0,
430 Http503ResponseVerbosityLimited,
431 Http503ResponseVerbosityFull
432 } HTTP_503_RESPONSE_VERBOSITY, *PHTTP_503_RESPONSE_VERBOSITY;
433
434 typedef enum _HTTP_ENABLED_STATE {
435 HttpEnabledStateActive = 0,
436 HttpEnabledStateInactive
437 } HTTP_ENABLED_STATE, *PHTTP_ENABLED_STATE;
438
439 typedef enum _HTTP_LOGGING_ROLLOVER_TYPE {
440 HttpLoggingRolloverSize = 0,
441 HttpLoggingRolloverDaily,
442 HttpLoggingRolloverWeekly,
443 HttpLoggingRolloverMonthly,
444 HttpLoggingRolloverHourly
445 } HTTP_LOGGING_ROLLOVER_TYPE, *PHTTP_LOGGING_ROLLOVER_TYPE;
446
447 typedef enum _HTTP_LOGGING_TYPE {
448 HttpLoggingTypeW3C = 0,
449 HttpLoggingTypeIIS,
450 HttpLoggingTypeNCSA,
451 HttpLoggingTypeRaw
452 } HTTP_LOGGING_TYPE, *PHTTP_LOGGING_TYPE;
453
454 typedef enum _HTTP_QOS_SETTING_TYPE {
455 HttpQosSettingTypeBandwidth = 0,
456 HttpQosSettingTypeConnectionLimit,
457 HttpQosSettingTypeFlowRate
458 } HTTP_QOS_SETTING_TYPE, *PHTTP_QOS_SETTING_TYPE;
459
460 typedef enum _HTTP_SERVER_PROPERTY {
461 HttpServerAuthenticationProperty = 0,
462 HttpServerLoggingProperty,
463 HttpServerQosProperty,
464 HttpServerTimeoutsProperty,
465 HttpServerQueueLengthProperty,
466 HttpServerStateProperty,
467 HttpServer503VerbosityProperty,
468 HttpServerBindingProperty,
469 HttpServerExtendedAuthenticationProperty,
470 HttpServerListenEndpointProperty,
471 HttpServerChannelBindProperty
472 } HTTP_SERVER_PROPERTY, *PHTTP_SERVER_PROPERTY;
473
474 typedef enum _HTTP_AUTHENTICATION_HARDENING_LEVELS {
475 HttpAuthenticationHardeningLegacy = 0,
476 HttpAuthenticationHardeningMedium = 1,
477 HttpAuthenticationHardeningStrict = 2
478 } HTTP_AUTHENTICATION_HARDENING_LEVELS;
479
480 typedef enum _HTTP_SERVICE_BINDING_TYPE {
481 HttpServiceBindingTypeNone = 0,
482 HttpServiceBindingTypeW = 1,
483 HttpServiceBindingTypeA = 2
484 } HTTP_SERVICE_BINDING_TYPE;
485
486 typedef enum _HTTP_LOG_DATA_TYPE {
487 HttpLogDataTypeFields = 0
488 } HTTP_LOG_DATA_TYPE, *PHTTP_LOG_DATA_TYPE;
489
490 typedef struct _HTTP_LOG_DATA {
491 HTTP_LOG_DATA_TYPE Type;
492 } HTTP_LOG_DATA, *PHTTP_LOG_DATA;
493
494 typedef enum _HTTP_REQUEST_AUTH_TYPE {
495 HttpRequestAuthTypeNone = 0,
496 HttpRequestAuthTypeBasic,
497 HttpRequestAuthTypeDigest,
498 HttpRequestAuthTypeNTLM,
499 HttpRequestAuthTypeNegotiate,
500 HttpRequestAuthTypeKerberos
501 } HTTP_REQUEST_AUTH_TYPE, *PHTTP_REQUEST_AUTH_TYPE;
502
503 typedef enum _HTTP_AUTH_STATUS {
504 HttpAuthStatusSuccess = 0,
505 HttpAuthStatusNotAuthenticated,
506 HttpAuthStatusFailure
507 } HTTP_AUTH_STATUS, *PHTTP_AUTH_STATUS;
508
509 typedef enum _HTTP_SERVICE_CONFIG_TIMEOUT_KEY {
510 IdleConnectionTimeout = 0,
511 HeaderWaitTimeout
512 } HTTP_SERVICE_CONFIG_TIMEOUT_KEY, *PHTTP_SERVICE_CONFIG_TIMEOUT_KEY;
513
514 typedef USHORT HTTP_SERVICE_CONFIG_TIMEOUT_PARAM, *PHTTP_SERVICE_CONFIG_TIMEOUT_PARAM;
515
516 typedef struct _HTTP_PROPERTY_FLAGS {
517 ULONG Present:1;
518 } HTTP_PROPERTY_FLAGS, *PHTTP_PROPERTY_FLAGS;
519
520 typedef struct _HTTP_CONNECTION_LIMIT_INFO {
521 HTTP_PROPERTY_FLAGS Flags;
522 ULONG MaxConnections;
523 } HTTP_CONNECTION_LIMIT_INFO, *PHTTP_CONNECTION_LIMIT_INFO;
524
525 typedef struct _HTTP_STATE_INFO {
526 HTTP_PROPERTY_FLAGS Flags;
527 HTTP_ENABLED_STATE State;
528 } HTTP_STATE_INFO, *PHTTP_STATE_INFO;
529
530 typedef struct _HTTP_QOS_SETTING_INFO {
531 HTTP_QOS_SETTING_TYPE QosType;
532 PVOID QosSetting;
533 } HTTP_QOS_SETTING_INFO, *PHTTP_QOS_SETTING_INFO;
534
535 typedef struct _HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS {
536 USHORT DomainNameLength;
537 PWSTR DomainName;
538 USHORT RealmLength;
539 PWSTR Realm;
540 } HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS, *PHTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS;
541
542 typedef struct _HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS {
543 USHORT RealmLength;
544 PWSTR Realm;
545 } HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS, *PHTTP_SERVER_AUTHENTICATION_BASIC_PARAMS;
546
547 typedef struct _HTTP_SERVER_AUTHENTICATION_INFO {
548 HTTP_PROPERTY_FLAGS Flags;
549 ULONG AuthSchemes;
550 BOOLEAN ReceiveMutualAuth;
551 BOOLEAN ReceiveContextHandle;
552 BOOLEAN DisableNTLMCredentialCaching;
553 UCHAR ExFlags;
554 HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS DigestParams;
555 HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS BasicParams;
556 } HTTP_SERVER_AUTHENTICATION_INFO, *PHTTP_SERVER_AUTHENTICATION_INFO;
557
558 typedef struct _HTTP_LOGGING_INFO {
559 HTTP_PROPERTY_FLAGS Flags;
560 ULONG LoggingFlags;
561 PCWSTR SoftwareName;
562 USHORT SoftwareNameLength;
563 USHORT DirectoryNameLength;
564 PCWSTR DirectoryName;
565 HTTP_LOGGING_TYPE Format;
566 ULONG Fields;
567 PVOID pExtFields;
568 USHORT NumOfExtFields;
569 USHORT MaxRecordSize;
570 HTTP_LOGGING_ROLLOVER_TYPE RolloverType;
571 ULONG RolloverSize;
572 PSECURITY_DESCRIPTOR pSecurityDescriptor;
573 } HTTP_LOGGING_INFO, *PHTTP_LOGGING_INFO;
574
575 typedef struct _HTTP_TIMEOUT_LIMIT_INFO {
576 HTTP_PROPERTY_FLAGS Flags;
577 USHORT EntityBody;
578 USHORT DrainEntityBody;
579 USHORT RequestQueue;
580 USHORT IdleConnection;
581 USHORT HeaderWait;
582 ULONG MinSendRate;
583 } HTTP_TIMEOUT_LIMIT_INFO, *PHTTP_TIMEOUT_LIMIT_INFO;
584
585 typedef struct _HTTP_SERVICE_BINDING_BASE {
586 HTTP_SERVICE_BINDING_TYPE Type;
587 } HTTP_SERVICE_BINDING_BASE, *PHTTP_SERVICE_BINDING_BASE;
588
589 typedef struct _HTTP_CHANNEL_BIND_INFO {
590 HTTP_AUTHENTICATION_HARDENING_LEVELS Hardening;
591 ULONG Flags;
592 PHTTP_SERVICE_BINDING_BASE *ServiceNames;
593 ULONG NumberOfServiceNames;
594 } HTTP_CHANNEL_BIND_INFO, *PHTTP_CHANNEL_BIND_INFO;
595
596 typedef struct _HTTP_REQUEST_CHANNEL_BIND_STATUS {
597 PHTTP_SERVICE_BINDING_BASE ServiceName;
598 PUCHAR ChannelToken;
599 ULONG ChannelTokenSize;
600 ULONG Flags;
601 } HTTP_REQUEST_CHANNEL_BIND_STATUS, *PHTTP_REQUEST_CHANNEL_BIND_STATUS;
602
603 typedef struct _HTTP_SERVICE_BINDING_A {
604 HTTP_SERVICE_BINDING_BASE Base;
605 PCHAR Buffer;
606 ULONG BufferSize;
607 } HTTP_SERVICE_BINDING_A, *PHTTP_SERVICE_BINDING_A;
608
609 typedef struct _HTTP_SERVICE_BINDING_W {
610 HTTP_SERVICE_BINDING_BASE Base;
611 PWCHAR Buffer;
612 ULONG BufferSize;
613 } HTTP_SERVICE_BINDING_W, *PHTTP_SERVICE_BINDING_W;
614
615 /* TODO: Is there the abstract unicode type HTTP_SERVICE_BINDING present, too? */
616
617 typedef struct _HTTP_LOG_FIELDS_DATA {
618 HTTP_LOG_DATA Base;
619 USHORT UserNameLength;
620 USHORT UriStemLength;
621 USHORT ClientIpLength;
622 USHORT ServerNameLength;
623 USHORT ServerIpLength;
624 USHORT MethodLength;
625 USHORT UriQueryLength;
626 USHORT HostLength;
627 USHORT UserAgentLength;
628 USHORT CookieLength;
629 USHORT ReferrerLength;
630 PWCHAR UserName;
631 PWCHAR UriStem;
632 PCHAR ClientIp;
633 PCHAR ServerName;
634 PCHAR ServiceName;
635 PCHAR ServerIp;
636 PCHAR Method;
637 PCHAR UriQuery;
638 PCHAR Host;
639 PCHAR UserAgent;
640 PCHAR Cookie;
641 PCHAR Referrer;
642 USHORT ServerPort;
643 USHORT ProtocolStatus;
644 ULONG Win32Status;
645 HTTP_VERB MethodNum;
646 USHORT SubStatus;
647 } HTTP_LOG_FIELDS_DATA, *PHTTP_LOG_FIELDS_DATA;
648
649 typedef struct _HTTP_REQUEST_AUTH_INFO {
650 HTTP_AUTH_STATUS AuthStatus;
651 SECURITY_STATUS SecStatus;
652 ULONG Flags;
653 HTTP_REQUEST_AUTH_TYPE AuthType;
654 HANDLE AccessToken;
655 ULONG ContextAttributes;
656 ULONG PackedContextLength;
657 ULONG PackedContextType;
658 PVOID PackedContext;
659 ULONG MutualAuthDataLength;
660 PCHAR pMutualAuthData;
661 } HTTP_REQUEST_AUTH_INFO, *PHTTP_REQUEST_AUTH_INFO;
662
663 typedef struct _HTTP_MULTIPLE_KNOWN_HEADERS {
664 HTTP_HEADER_ID HeaderId;
665 ULONG Flags;
666 USHORT KnownHeaderCount;
667 PHTTP_KNOWN_HEADER KnownHeaders;
668 } HTTP_MULTIPLE_KNOWN_HEADERS, *PHTTP_MULTIPLE_KNOWN_HEADERS;
669
670 typedef struct _HTTP_SERVICE_CONFIG_TIMEOUT_SET {
671 HTTP_SERVICE_CONFIG_TIMEOUT_KEY KeyDesc;
672 HTTP_SERVICE_CONFIG_TIMEOUT_PARAM ParamDesc;
673 } HTTP_SERVICE_CONFIG_TIMEOUT_SET, *PHTTP_SERVICE_CONFIG_TIMEOUT_SET;
674
675 typedef struct _HTTP_BANDWIDTH_LIMIT_INFO {
676 HTTP_PROPERTY_FLAGS Flags;
677 ULONG MaxBandwidth;
678 } HTTP_BANDWIDTH_LIMIT_INFO, *PHTTP_BANDWIDTH_LIMIT_INFO;
679
680 typedef struct _HTTP_BINDING_INFO {
681 HTTP_PROPERTY_FLAGS Flags;
682 HANDLE RequestQueueHandle;
683 } HTTP_BINDING_INFO, *PHTTP_BINDING_INFO;
684
685 typedef struct _HTTP_LISTEN_ENDPOINT_INFO {
686 HTTP_PROPERTY_FLAGS Flags;
687 BOOLEAN EnableSharing;
688 } HTTP_LISTEN_ENDPOINT_INFO, *PHTTP_LISTEN_ENDPOINT_INFO;
689
690 HTTPAPI_LINKAGE ULONG WINAPI HttpSetRequestQueueProperty(HANDLE Handle,HTTP_SERVER_PROPERTY Property,PVOID pPropertyInformation,ULONG PropertyInformationLength,ULONG Reserved,PVOID pReserved);
691 HTTPAPI_LINKAGE ULONG WINAPI HttpQueryRequestQueueProperty(HANDLE Handle,HTTP_SERVER_PROPERTY Property,PVOID pPropertyInformation,ULONG PropertyInformationLength,ULONG Reserved,PULONG pReturnLength,PVOID pReserved);
692 HTTPAPI_LINKAGE ULONG WINAPI HttpCreateRequestQueue(HTTPAPI_VERSION Version,PCWSTR pName,PSECURITY_ATTRIBUTES pSecurityAttributes,ULONG Flags,PHANDLE pReqQueueHandle);
693 HTTPAPI_LINKAGE ULONG WINAPI HttpAddUrlToUrlGroup(HTTP_URL_GROUP_ID UrlGroupId,PCWSTR pFullyQualifiedUrl,HTTP_URL_CONTEXT UrlContext,ULONG Reserved);
694 HTTPAPI_LINKAGE ULONG WINAPI HttpCancelHttpRequest(HANDLE ReqQueueHandle,HTTP_REQUEST_ID RequestId,LPOVERLAPPED pOverlapped);
695 HTTPAPI_LINKAGE ULONG WINAPI HttpCloseRequestQueue(HANDLE ReqQueueHandle);
696 HTTPAPI_LINKAGE ULONG WINAPI HttpCloseServerSession(HTTP_SERVER_SESSION_ID ServerSessionId);
697 HTTPAPI_LINKAGE ULONG WINAPI HttpCloseUrlGroup(HTTP_URL_GROUP_ID UrlGroupId);
698 HTTPAPI_LINKAGE ULONG WINAPI HttpCreateServerSession(HTTPAPI_VERSION Version,PHTTP_SERVER_SESSION_ID pServerSessionId,ULONG Reserved);
699 HTTPAPI_LINKAGE ULONG WINAPI HttpCreateUrlGroup(HTTP_SERVER_SESSION_ID ServerSessionId,PHTTP_URL_GROUP_ID pUrlGroupId,ULONG Reserved);
700 HTTPAPI_LINKAGE ULONG WINAPI HttpQueryServerSessionProperty(HTTP_SERVER_SESSION_ID ServerSessionId,HTTP_SERVER_PROPERTY Property,PVOID pPropertyInformation,ULONG PropertyInformationLength,PULONG pReturnLength);
701 HTTPAPI_LINKAGE ULONG WINAPI HttpQueryUrlGroupProperty(HTTP_URL_GROUP_ID UrlGroupId,HTTP_SERVER_PROPERTY Property,PVOID pPropertyInformation,ULONG PropertyInformationLength,PULONG pReturnLength);
702 HTTPAPI_LINKAGE ULONG WINAPI HttpRemoveUrlFromUrlGroup(HTTP_URL_GROUP_ID UrlGroupId,PCWSTR pFullyQualifiedUrl,ULONG Flags);
703 HTTPAPI_LINKAGE ULONG WINAPI HttpSetServerSessionProperty(HTTP_SERVER_SESSION_ID ServerSessionId,HTTP_SERVER_PROPERTY Property,PVOID pPropertyInformation,ULONG PropertyInformationLength);
704 HTTPAPI_LINKAGE ULONG WINAPI HttpSetUrlGroupProperty(HTTP_URL_GROUP_ID UrlGroupId,HTTP_SERVER_PROPERTY Property,PVOID pPropertyInformation,ULONG PropertyInformationLength);
705 HTTPAPI_LINKAGE ULONG WINAPI HttpShutdownRequestQueue(HANDLE ReqQueueHandle);
706 HTTPAPI_LINKAGE ULONG WINAPI HttpWaitForDemandStart(HANDLE ReqQueueHandle,LPOVERLAPPED pOverlapped);
707
708#if (_WIN32_WINNT >= 0x0601)
709 typedef ULONG HTTP_SERVICE_CONFIG_CACHE_PARAM;
710
711 typedef enum _HTTP_SERVICE_CONFIG_CACHE_KEY {
712 MaxCacheResponseSize = 0,
713 CacheRangeChunkSize
714 } HTTP_SERVICE_CONFIG_CACHE_KEY;
715
716 typedef struct _HTTP_FLOWRATE_INFO {
717 HTTP_PROPERTY_FLAGS Flags;
718 ULONG MaxBandwidth;
719 ULONG MaxPeakBandwidth;
720 ULONG BurstSize;
721 } HTTP_FLOWRATE_INFO, *PHTTP_FLOWRATE_INFO;
722
723typedef struct _HTTP_SERVICE_CONFIG_CACHE_SET {
724 HTTP_SERVICE_CONFIG_CACHE_KEY KeyDesc;
725 HTTP_SERVICE_CONFIG_CACHE_PARAM ParamDesc;
726} HTTP_SERVICE_CONFIG_CACHE_SET, *PHTTP_SERVICE_CONFIG_CACHE_SET;
727
728#endif /*(_WIN32_WINNT >= 0x0601)*/
729
730#endif /*(_WIN32_WINNT >= 0x0600)*/
731
732#ifdef __cplusplus
733}
734#endif
735
736#endif /* __HTTP_H__ */