You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
517 lines
17 KiB
517 lines
17 KiB
/********
|
|
*
|
|
* Copyright (c) 1995 Process Software Corporation
|
|
*
|
|
* Copyright (c) 1995-1999 Microsoft Corporation
|
|
*
|
|
*
|
|
* Module Name : HttpExt.h
|
|
*
|
|
* Abstract :
|
|
*
|
|
* This module contains the structure definitions and prototypes for the
|
|
* HTTP Server Extension interface used to build ISAPI Applications
|
|
*
|
|
******************/
|
|
|
|
#ifndef _HTTPEXT_H_
|
|
#define _HTTPEXT_H_
|
|
|
|
#include <windows.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
/************************************************************
|
|
* Manifest Constants
|
|
************************************************************/
|
|
|
|
#define HSE_VERSION_MAJOR 6 // major version of this spec
|
|
#define HSE_VERSION_MINOR 0 // minor version of this spec
|
|
#define HSE_LOG_BUFFER_LEN 80
|
|
#define HSE_MAX_EXT_DLL_NAME_LEN 256
|
|
|
|
#define HSE_VERSION MAKELONG( HSE_VERSION_MINOR, HSE_VERSION_MAJOR )
|
|
|
|
//
|
|
// the following are the status codes returned by the Extension DLL
|
|
//
|
|
|
|
#define HSE_STATUS_SUCCESS 1
|
|
#define HSE_STATUS_SUCCESS_AND_KEEP_CONN 2
|
|
#define HSE_STATUS_PENDING 3
|
|
#define HSE_STATUS_ERROR 4
|
|
|
|
//
|
|
// The following are the values to request services with the
|
|
// ServerSupportFunction().
|
|
// Values from 0 to 1000 are reserved for future versions of the interface
|
|
|
|
#define HSE_REQ_BASE 0
|
|
#define HSE_REQ_SEND_URL_REDIRECT_RESP ( HSE_REQ_BASE + 1 )
|
|
#define HSE_REQ_SEND_URL ( HSE_REQ_BASE + 2 )
|
|
#define HSE_REQ_SEND_RESPONSE_HEADER ( HSE_REQ_BASE + 3 )
|
|
#define HSE_REQ_DONE_WITH_SESSION ( HSE_REQ_BASE + 4 )
|
|
#define HSE_REQ_END_RESERVED 1000
|
|
|
|
//
|
|
// These are Microsoft specific extensions
|
|
//
|
|
|
|
#define HSE_REQ_MAP_URL_TO_PATH (HSE_REQ_END_RESERVED+1)
|
|
#define HSE_REQ_GET_SSPI_INFO (HSE_REQ_END_RESERVED+2)
|
|
#define HSE_APPEND_LOG_PARAMETER (HSE_REQ_END_RESERVED+3)
|
|
#define HSE_REQ_IO_COMPLETION (HSE_REQ_END_RESERVED+5)
|
|
#define HSE_REQ_TRANSMIT_FILE (HSE_REQ_END_RESERVED+6)
|
|
#define HSE_REQ_REFRESH_ISAPI_ACL (HSE_REQ_END_RESERVED+7)
|
|
#define HSE_REQ_IS_KEEP_CONN (HSE_REQ_END_RESERVED+8)
|
|
#define HSE_REQ_ASYNC_READ_CLIENT (HSE_REQ_END_RESERVED+10)
|
|
#define HSE_REQ_GET_IMPERSONATION_TOKEN (HSE_REQ_END_RESERVED+11)
|
|
#define HSE_REQ_MAP_URL_TO_PATH_EX (HSE_REQ_END_RESERVED+12)
|
|
#define HSE_REQ_ABORTIVE_CLOSE (HSE_REQ_END_RESERVED+14)
|
|
#define HSE_REQ_GET_CERT_INFO_EX (HSE_REQ_END_RESERVED+15)
|
|
#define HSE_REQ_SEND_RESPONSE_HEADER_EX (HSE_REQ_END_RESERVED+16)
|
|
#define HSE_REQ_CLOSE_CONNECTION (HSE_REQ_END_RESERVED+17)
|
|
#define HSE_REQ_IS_CONNECTED (HSE_REQ_END_RESERVED+18)
|
|
#define HSE_REQ_MAP_UNICODE_URL_TO_PATH (HSE_REQ_END_RESERVED+23)
|
|
#define HSE_REQ_MAP_UNICODE_URL_TO_PATH_EX (HSE_REQ_END_RESERVED+24)
|
|
#define HSE_REQ_EXEC_UNICODE_URL (HSE_REQ_END_RESERVED+25)
|
|
#define HSE_REQ_EXEC_URL (HSE_REQ_END_RESERVED+26)
|
|
#define HSE_REQ_GET_EXEC_URL_STATUS (HSE_REQ_END_RESERVED+27)
|
|
#define HSE_REQ_SEND_CUSTOM_ERROR (HSE_REQ_END_RESERVED+28)
|
|
#define HSE_REQ_IS_IN_PROCESS (HSE_REQ_END_RESERVED+30)
|
|
#define HSE_REQ_REPORT_UNHEALTHY (HSE_REQ_END_RESERVED+32)
|
|
#define HSE_REQ_NORMALIZE_URL (HSE_REQ_END_RESERVED+33)
|
|
#define HSE_REQ_VECTOR_SEND (HSE_REQ_END_RESERVED+37)
|
|
#define HSE_REQ_GET_ANONYMOUS_TOKEN (HSE_REQ_END_RESERVED+38)
|
|
#define HSE_REQ_GET_CACHE_INVALIDATION_CALLBACK (HSE_REQ_END_RESERVED+40)
|
|
#define HSE_REQ_GET_UNICODE_ANONYMOUS_TOKEN (HSE_REQ_END_RESERVED+41)
|
|
|
|
//
|
|
// Bit Flags for TerminateExtension
|
|
//
|
|
// HSE_TERM_ADVISORY_UNLOAD - Server wants to unload the extension,
|
|
// extension can return TRUE if OK, FALSE if the server should not
|
|
// unload the extension
|
|
//
|
|
// HSE_TERM_MUST_UNLOAD - Server indicating the extension is about to be
|
|
// unloaded, the extension cannot refuse.
|
|
//
|
|
|
|
#define HSE_TERM_ADVISORY_UNLOAD 0x00000001
|
|
#define HSE_TERM_MUST_UNLOAD 0x00000002
|
|
|
|
//
|
|
// Flags for IO Functions, supported for IO Funcs.
|
|
// TF means ServerSupportFunction( HSE_REQ_TRANSMIT_FILE)
|
|
//
|
|
|
|
# define HSE_IO_SYNC 0x00000001 // for WriteClient
|
|
# define HSE_IO_ASYNC 0x00000002 // for WriteClient/TF/EU
|
|
# define HSE_IO_DISCONNECT_AFTER_SEND 0x00000004 // for TF
|
|
# define HSE_IO_SEND_HEADERS 0x00000008 // for TF
|
|
# define HSE_IO_NODELAY 0x00001000 // turn off nagling
|
|
|
|
//
|
|
// These two are only used by VectorSend
|
|
//
|
|
|
|
# define HSE_IO_FINAL_SEND 0x00000010
|
|
# define HSE_IO_CACHE_RESPONSE 0x00000020
|
|
|
|
|
|
/************************************************************
|
|
* Type Definitions
|
|
************************************************************/
|
|
|
|
typedef LPVOID HCONN;
|
|
|
|
//
|
|
// structure passed to GetExtensionVersion()
|
|
//
|
|
|
|
typedef struct _HSE_VERSION_INFO {
|
|
|
|
DWORD dwExtensionVersion;
|
|
CHAR lpszExtensionDesc[HSE_MAX_EXT_DLL_NAME_LEN];
|
|
|
|
} HSE_VERSION_INFO, *LPHSE_VERSION_INFO;
|
|
|
|
|
|
//
|
|
// structure passed to extension procedure on a new request
|
|
//
|
|
typedef struct _EXTENSION_CONTROL_BLOCK {
|
|
|
|
DWORD cbSize; // size of this struct.
|
|
DWORD dwVersion; // version info of this spec
|
|
HCONN ConnID; // Context number not to be modified!
|
|
DWORD dwHttpStatusCode; // HTTP Status code
|
|
CHAR lpszLogData[HSE_LOG_BUFFER_LEN];// null terminated log info specific to this Extension DLL
|
|
|
|
LPSTR lpszMethod; // REQUEST_METHOD
|
|
LPSTR lpszQueryString; // QUERY_STRING
|
|
LPSTR lpszPathInfo; // PATH_INFO
|
|
LPSTR lpszPathTranslated; // PATH_TRANSLATED
|
|
|
|
DWORD cbTotalBytes; // Total bytes indicated from client
|
|
DWORD cbAvailable; // Available number of bytes
|
|
LPBYTE lpbData; // pointer to cbAvailable bytes
|
|
|
|
LPSTR lpszContentType; // Content type of client data
|
|
|
|
BOOL (WINAPI * GetServerVariable) ( HCONN hConn,
|
|
LPSTR lpszVariableName,
|
|
LPVOID lpvBuffer,
|
|
LPDWORD lpdwSize );
|
|
|
|
BOOL (WINAPI * WriteClient) ( HCONN ConnID,
|
|
LPVOID Buffer,
|
|
LPDWORD lpdwBytes,
|
|
DWORD dwReserved );
|
|
|
|
BOOL (WINAPI * ReadClient) ( HCONN ConnID,
|
|
LPVOID lpvBuffer,
|
|
LPDWORD lpdwSize );
|
|
|
|
BOOL (WINAPI * ServerSupportFunction)( HCONN hConn,
|
|
DWORD dwHSERequest,
|
|
LPVOID lpvBuffer,
|
|
LPDWORD lpdwSize,
|
|
LPDWORD lpdwDataType );
|
|
|
|
} EXTENSION_CONTROL_BLOCK, *LPEXTENSION_CONTROL_BLOCK;
|
|
|
|
|
|
|
|
|
|
//
|
|
// Bit field of flags that can be on a virtual directory
|
|
//
|
|
|
|
#define HSE_URL_FLAGS_READ 0x00000001 // Allow for Read
|
|
#define HSE_URL_FLAGS_WRITE 0x00000002 // Allow for Write
|
|
#define HSE_URL_FLAGS_EXECUTE 0x00000004 // Allow for Execute
|
|
#define HSE_URL_FLAGS_SSL 0x00000008 // Require SSL
|
|
#define HSE_URL_FLAGS_DONT_CACHE 0x00000010 // Don't cache (vroot only)
|
|
#define HSE_URL_FLAGS_NEGO_CERT 0x00000020 // Allow client SSL certs
|
|
#define HSE_URL_FLAGS_REQUIRE_CERT 0x00000040 // Require client SSL certs
|
|
#define HSE_URL_FLAGS_MAP_CERT 0x00000080 // Map SSL cert to NT account
|
|
#define HSE_URL_FLAGS_SSL128 0x00000100 // Require 128 bit SSL
|
|
#define HSE_URL_FLAGS_SCRIPT 0x00000200 // Allow for Script execution
|
|
|
|
#define HSE_URL_FLAGS_MASK 0x000003ff
|
|
|
|
//
|
|
// Structure for extended information on a URL mapping
|
|
//
|
|
|
|
typedef struct _HSE_URL_MAPEX_INFO {
|
|
|
|
CHAR lpszPath[MAX_PATH]; // Physical path root mapped to
|
|
DWORD dwFlags; // Flags associated with this URL path
|
|
DWORD cchMatchingPath; // Number of matching characters in physical path
|
|
DWORD cchMatchingURL; // Number of matching characters in URL
|
|
|
|
DWORD dwReserved1;
|
|
DWORD dwReserved2;
|
|
|
|
} HSE_URL_MAPEX_INFO, * LPHSE_URL_MAPEX_INFO;
|
|
|
|
|
|
typedef struct _HSE_UNICODE_URL_MAPEX_INFO {
|
|
|
|
WCHAR lpszPath[MAX_PATH]; // Physical path root mapped to
|
|
DWORD dwFlags; // Flags associated with this URL path
|
|
DWORD cchMatchingPath; // Number of matching characters in physical path
|
|
DWORD cchMatchingURL; // Number of matching characters in URL
|
|
|
|
} HSE_UNICODE_URL_MAPEX_INFO, * LPHSE_UNICODE_URL_MAPEX_INFO;
|
|
|
|
|
|
//
|
|
// PFN_HSE_IO_COMPLETION - callback function for the Async I/O Completion.
|
|
//
|
|
|
|
typedef VOID
|
|
(WINAPI * PFN_HSE_IO_COMPLETION)(
|
|
IN EXTENSION_CONTROL_BLOCK * pECB,
|
|
IN PVOID pContext,
|
|
IN DWORD cbIO,
|
|
IN DWORD dwError
|
|
);
|
|
|
|
|
|
|
|
//
|
|
// HSE_TF_INFO defines the type for HTTP SERVER EXTENSION support for
|
|
// ISAPI applications to send files using TransmitFile.
|
|
// A pointer to this object should be used with ServerSupportFunction()
|
|
// for HSE_REQ_TRANSMIT_FILE.
|
|
//
|
|
|
|
typedef struct _HSE_TF_INFO {
|
|
|
|
//
|
|
// callback and context information
|
|
// the callback function will be called when IO is completed.
|
|
// the context specified will be used during such callback.
|
|
//
|
|
// These values (if non-NULL) will override the one set by calling
|
|
// ServerSupportFunction() with HSE_REQ_IO_COMPLETION
|
|
//
|
|
PFN_HSE_IO_COMPLETION pfnHseIO;
|
|
PVOID pContext;
|
|
|
|
// file should have been opened with FILE_FLAG_SEQUENTIAL_SCAN
|
|
HANDLE hFile;
|
|
|
|
//
|
|
// HTTP header and status code
|
|
// These fields are used only if HSE_IO_SEND_HEADERS is present in dwFlags
|
|
//
|
|
|
|
LPCSTR pszStatusCode; // HTTP Status Code eg: "200 OK"
|
|
|
|
DWORD BytesToWrite; // special value of "0" means write entire file.
|
|
DWORD Offset; // offset value within the file to start from
|
|
|
|
PVOID pHead; // Head buffer to be sent before file data
|
|
DWORD HeadLength; // header length
|
|
PVOID pTail; // Tail buffer to be sent after file data
|
|
DWORD TailLength; // tail length
|
|
|
|
DWORD dwFlags; // includes HSE_IO_DISCONNECT_AFTER_SEND, ...
|
|
|
|
} HSE_TF_INFO, * LPHSE_TF_INFO;
|
|
|
|
|
|
//
|
|
// HSE_SEND_HEADER_EX_INFO allows an ISAPI application to send headers
|
|
// and specify keep-alive behavior in the same call.
|
|
//
|
|
|
|
typedef struct _HSE_SEND_HEADER_EX_INFO {
|
|
|
|
//
|
|
// HTTP status code and header
|
|
//
|
|
|
|
LPCSTR pszStatus; // HTTP status code eg: "200 OK"
|
|
LPCSTR pszHeader; // HTTP header
|
|
|
|
DWORD cchStatus; // number of characters in status code
|
|
DWORD cchHeader; // number of characters in header
|
|
|
|
BOOL fKeepConn; // keep client connection alive?
|
|
|
|
} HSE_SEND_HEADER_EX_INFO, * LPHSE_SEND_HEADER_EX_INFO;
|
|
|
|
//
|
|
// Flags for use with HSE_REQ_EXEC_URL
|
|
//
|
|
|
|
#define HSE_EXEC_URL_NO_HEADERS 0x02
|
|
#define HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR 0x04
|
|
#define HSE_EXEC_URL_IGNORE_VALIDATION_AND_RANGE 0x10
|
|
#define HSE_EXEC_URL_DISABLE_CUSTOM_ERROR 0x20
|
|
#define HSE_EXEC_URL_SSI_CMD 0x40
|
|
|
|
//
|
|
// HSE_EXEC_URL_USER_INFO provides a new user content for use with
|
|
// HSE_REQ_EXEC_URL
|
|
//
|
|
|
|
typedef struct _HSE_EXEC_URL_USER_INFO {
|
|
|
|
HANDLE hImpersonationToken;
|
|
LPSTR pszCustomUserName;
|
|
LPSTR pszCustomAuthType;
|
|
|
|
} HSE_EXEC_URL_USER_INFO, * LPHSE_EXEC_URL_USER_INFO;
|
|
|
|
//
|
|
// HSE_EXEC_URL_ENTITY_INFO describes the entity body to be provided
|
|
// to the executed request using HSE_REQ_EXEC_URL
|
|
//
|
|
|
|
typedef struct _HSE_EXEC_URL_ENTITY_INFO {
|
|
|
|
DWORD cbAvailable;
|
|
LPVOID lpbData;
|
|
|
|
} HSE_EXEC_URL_ENTITY_INFO, * LPHSE_EXEC_URL_ENTITY_INFO;
|
|
|
|
//
|
|
// HSE_EXEC_URL_STATUS provides the status of the last HSE_REQ_EXEC_URL
|
|
// call
|
|
//
|
|
|
|
typedef struct _HSE_EXEC_URL_STATUS {
|
|
|
|
USHORT uHttpStatusCode;
|
|
USHORT uHttpSubStatus;
|
|
DWORD dwWin32Error;
|
|
|
|
} HSE_EXEC_URL_STATUS, * LPHSE_EXEC_URL_STATUS;
|
|
|
|
//
|
|
// HSE_EXEC_URL_INFO provides a description of the request to execute
|
|
// on behalf of the ISAPI.
|
|
//
|
|
|
|
typedef struct _HSE_EXEC_URL_INFO {
|
|
|
|
LPSTR pszUrl; // URL to execute
|
|
LPSTR pszMethod; // Method
|
|
LPSTR pszChildHeaders; // Request headers for child
|
|
LPHSE_EXEC_URL_USER_INFO pUserInfo; // User for new request
|
|
LPHSE_EXEC_URL_ENTITY_INFO pEntity; // Entity body for new request
|
|
DWORD dwExecUrlFlags; // Flags
|
|
|
|
} HSE_EXEC_URL_INFO, * LPHSE_EXEC_URL_INFO;
|
|
|
|
//
|
|
// HSE_EXEC_UNICODE_URL_USER_INFO provides a new user content for use with
|
|
// HSE_REQ_EXEC_UNICODE_URL
|
|
//
|
|
|
|
typedef struct _HSE_EXEC_UNICODE_URL_USER_INFO {
|
|
|
|
HANDLE hImpersonationToken;
|
|
LPWSTR pszCustomUserName;
|
|
LPSTR pszCustomAuthType;
|
|
|
|
} HSE_EXEC_UNICODE_URL_USER_INFO, * LPHSE_EXEC_UNICODE_URL_USER_INFO;
|
|
|
|
//
|
|
// HSE_EXEC_UNICODE_URL_INFO provides a description of the request to execute
|
|
// on behalf of the ISAPI.
|
|
//
|
|
|
|
typedef struct _HSE_EXEC_UNICODE_URL_INFO {
|
|
|
|
LPWSTR pszUrl; // URL to execute
|
|
LPSTR pszMethod; // Method
|
|
LPSTR pszChildHeaders; // Request headers for child
|
|
LPHSE_EXEC_UNICODE_URL_USER_INFO pUserInfo; // User for new request
|
|
LPHSE_EXEC_URL_ENTITY_INFO pEntity; // Entity body for new request
|
|
DWORD dwExecUrlFlags; // Flags
|
|
|
|
} HSE_EXEC_UNICODE_URL_INFO, * LPHSE_EXEC_UNICODE_URL_INFO;
|
|
|
|
//
|
|
// HSE_CUSTOM_ERROR_INFO structured used in HSE_REQ_SEND_CUSTOM_ERROR
|
|
//
|
|
|
|
typedef struct _HSE_CUSTOM_ERROR_INFO {
|
|
|
|
CHAR * pszStatus;
|
|
USHORT uHttpSubError;
|
|
BOOL fAsync;
|
|
|
|
} HSE_CUSTOM_ERROR_INFO, * LPHSE_CUSTOM_ERROR_INFO;
|
|
|
|
|
|
//
|
|
// structures for the HSE_REQ_VECTOR_SEND ServerSupportFunction
|
|
//
|
|
|
|
|
|
//
|
|
// Types of vector-elements currently supported
|
|
//
|
|
#define HSE_VECTOR_ELEMENT_TYPE_MEMORY_BUFFER 0
|
|
#define HSE_VECTOR_ELEMENT_TYPE_FILE_HANDLE 1
|
|
|
|
//
|
|
// element of the vector
|
|
//
|
|
|
|
typedef struct _HSE_VECTOR_ELEMENT
|
|
{
|
|
DWORD ElementType; // Type of element (buffer/file/fragment etc)
|
|
|
|
PVOID pvContext; // The context representing the element to be sent
|
|
|
|
ULONGLONG cbOffset; // Offset from the start of hFile
|
|
|
|
ULONGLONG cbSize; // Number of bytes to send
|
|
} HSE_VECTOR_ELEMENT, *LPHSE_VECTOR_ELEMENT;
|
|
|
|
//
|
|
// The whole vector to be passed to the ServerSupportFunction
|
|
//
|
|
|
|
typedef struct _HSE_RESPONSE_VECTOR
|
|
{
|
|
DWORD dwFlags; // combination of HSE_IO_* flags
|
|
|
|
LPSTR pszStatus; // Status line to send like "200 OK"
|
|
LPSTR pszHeaders; // Headers to send
|
|
|
|
DWORD nElementCount; // Number of HSE_VECTOR_ELEMENT's
|
|
LPHSE_VECTOR_ELEMENT lpElementArray; // Pointer to those elements
|
|
} HSE_RESPONSE_VECTOR, *LPHSE_RESPONSE_VECTOR;
|
|
|
|
|
|
typedef HRESULT
|
|
(WINAPI * PFN_HSE_CACHE_INVALIDATION_CALLBACK)(
|
|
WCHAR *pszUrl);
|
|
|
|
|
|
#if(_WIN32_WINNT >= 0x400)
|
|
#include <wincrypt.h>
|
|
//
|
|
// CERT_CONTEXT_EX is passed as an an argument to
|
|
// ServerSupportFunction( HSE_REQ_GET_CERT_INFO_EX )
|
|
//
|
|
|
|
typedef struct _CERT_CONTEXT_EX {
|
|
CERT_CONTEXT CertContext;
|
|
DWORD cbAllocated;
|
|
DWORD dwCertificateFlags;
|
|
} CERT_CONTEXT_EX;
|
|
#endif
|
|
|
|
|
|
|
|
//
|
|
// Flags for determining application type
|
|
//
|
|
|
|
#define HSE_APP_FLAG_IN_PROCESS 0
|
|
#define HSE_APP_FLAG_ISOLATED_OOP 1
|
|
#define HSE_APP_FLAG_POOLED_OOP 2
|
|
|
|
|
|
/************************************************************
|
|
* Function Prototypes
|
|
* o for functions exported from the ISAPI Application DLL
|
|
************************************************************/
|
|
|
|
BOOL WINAPI GetExtensionVersion( HSE_VERSION_INFO *pVer );
|
|
DWORD WINAPI HttpExtensionProc( EXTENSION_CONTROL_BLOCK *pECB );
|
|
BOOL WINAPI TerminateExtension( DWORD dwFlags );
|
|
|
|
// the following type declarations is for use in the server side
|
|
|
|
typedef BOOL
|
|
(WINAPI * PFN_GETEXTENSIONVERSION)( HSE_VERSION_INFO *pVer );
|
|
|
|
typedef DWORD
|
|
(WINAPI * PFN_HTTPEXTENSIONPROC )( EXTENSION_CONTROL_BLOCK * pECB );
|
|
|
|
typedef BOOL (WINAPI * PFN_TERMINATEEXTENSION )( DWORD dwFlags );
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif // end definition _HTTPEXT_H_
|
|
|
|
|