API di HTTP Server

Panoramica della tecnologia API HTTP Server.

Per sviluppare l'API server HTTP, sono necessarie queste intestazioni:

• http.h

Per indicazioni sulla programmazione per questa tecnologia, vedere:

• API di HTTP Server

Enumerazioni

HTTP_503_RESPONSE_VERBOSITY L'enumerazione HTTP_503_RESPONSE_VERBOSITY definisce i livelli di verbosità per un servizio 503, il servizio non disponibile, le risposte agli errori. Questa struttura deve essere usata quando si imposta o si esegue una query su HttpServer503ResponseProperty in una coda di richieste.
HTTP_AUTH_STATUS Definisce lo stato di autenticazione di una richiesta.
HTTP_AUTHENTICATION_HARDENING_LEVELS Livello di protezione avanzata del server.
HTTP_CACHE_POLICY_TYPE Il tipo di enumerazione HTTP_CACHE_POLICY_TYPE definisce i criteri di cache disponibili.
HTTP_DATA_CHUNK_TYPE Definisce l'origine dati per un blocco di dati.
HTTP_DELEGATE_REQUEST_PROPERTY_ID Descrive le informazioni sulla proprietà per una richiesta delegata.
HTTP_ENABLED_STATE Definisce lo stato di una coda di richieste, di una sessione server o di un gruppo di URL.
HTTP_FEATURE_ID Definisce le costanti che specificano un identificatore per una funzionalità HTTP.
HTTP_HEADER_ID Il tipo di enumerazione HTTP_HEADER_ID elenca le intestazioni note per le richieste e le risposte HTTP e associa un indice di matrice a ogni intestazione.
HTTP_LOG_DATA_TYPE Identifica il tipo di dati di log.
HTTP_LOGGING_ROLLOVER_TYPE Definisce i tipi di rollover del file di log.
HTTP_LOGGING_TYPE Definisce il tipo di registrazione eseguita.
HTTP_QOS_SETTING_TYPE Identifica il tipo di un'impostazione QOS contenuta in una struttura HTTP_QOS_SETTING_INFO.
HTTP_REQUEST_AUTH_TYPE L'enumerazione HTTP_REQUEST_AUTH_TYPE definisce i tipi di autenticazione supportati dall'API server HTTP. Questa enumerazione viene usata nella struttura HTTP_REQUEST_AUTH_INFO.
HTTP_REQUEST_INFO_TYPE L'enumerazione HTTP_REQUEST_INFO_TYPE definisce il tipo di informazioni contenute nella struttura HTTP_REQUEST_INFO .
HTTP_REQUEST_PROPERTY Definisce le proprietà configurate dall'API server HTTP in una richiesta.
HTTP_REQUEST_TIMING_TYPE Definisce le costanti che specificano i possibili tempi di richiesta per i quali verranno restituite informazioni in HTTP_REQUEST_TIMING_INFO.
HTTP_RESPONSE_INFO_TYPE L'enumerazione HTTP_RESPONSE_INFO_TYPE definisce il tipo di informazioni contenute nella struttura HTTP_RESPONSE_INFO. Questa enumerazione viene usata nella struttura HTTP_RESPONSE_INFO.
HTTP_SERVER_PROPERTY Definisce le proprietà configurate dall'API server HTTP in un gruppo di URL, una sessione del server o una coda di richieste.
HTTP_SERVICE_BINDING_TYPE HTTP_SERVICE_BINDING_TYPE tipo enumerato specifica il tipo di stringa per i nomi di servizio.
HTTP_SERVICE_CONFIG_CACHE_KEY Usato nelle funzioni HttpSetServiceConfiguration e HttpQueryServiceConfiguration.
HTTP_SERVICE_CONFIG_ID Definisce le opzioni di configurazione del servizio.
HTTP_SERVICE_CONFIG_QUERY_TYPE Il tipo di enumerazione HTTP_SERVICE_CONFIG_QUERY_TYPE definisce vari tipi di query da eseguire. Viene usato nelle strutture HTTP_SERVICE_CONFIG_SSL_QUERY, HTTP_SERVICE_CONFIG_SSL_CCS_QUERY e HTTP_SERVICE_CONFIG_URLACL_QUERY.
HTTP_SERVICE_CONFIG_TIMEOUT_KEY L'enumerazione HTTP_SERVICE_CONFIG_TIMEOUT_KEY definisce il tipo di timer sottoposto a query o configurato tramite la struttura HTTP_SERVICE_CONFIG_TIMEOUT_SET.
HTTP_VERB Il tipo di enumerazione HTTP_VERB definisce i valori usati per specificare verbi HTTP noti e standard nella struttura HTTP_REQUEST. La maggior parte di questi verbi noti sono documentati in RFC 2616 e RFC 2518, come indicato di seguito.

Funzioni

HTTP_EQUAL_VERSION Restituisce un valore diverso da zero se una struttura HTTP_VERSION è uguale a una combinazione di versione principale/secondaria specificata o zero in caso contrario.
HTTP_GREATER_EQUAL_VERSION La macro HTTP_GREATER_EQUAL_VERSION restituisce un valore diverso da zero se una struttura HTTP_VERSION è maggiore o uguale a una combinazione di versione principale/secondaria specificata o zero in caso contrario.
HTTP_GREATER_VERSION Restituisce un valore diverso da zero se una struttura di HTTP_VERSION è maggiore di una combinazione di versione principale/secondaria specificata o zero in caso contrario.
HTTP_IS_NULL_ID Determina se l'HTTP_OPAQUE_ID è NULL.
HTTP_LESS_EQUAL_VERSION Restituisce un valore diverso da zero se una struttura di HTTP_VERSION è minore o uguale a una combinazione di versione principale/secondaria specificata o zero in caso contrario.
HTTP_LESS_VERSION Restituisce un valore diverso da zero se una struttura HTTP_VERSION è minore di una combinazione di versione principale/secondaria specificata o zero in caso contrario.
HTTP_NOT_EQUAL_VERSION Restituisce un valore diverso da zero se una struttura HTTP_VERSION è maggiore o minore di una combinazione di versione principale/secondaria specificata o zero se è uguale.
HTTP_SET_NULL_ID La macro HTTP_SET_NULL_ID imposta l'HTTP_OPAQUE_ID su NULL.
HTTP_SET_VERSION Imposta una struttura di HTTP_VERSION specificata su una combinazione di versione principale/secondaria specificata.
HttpAddFragmentToCache La funzione HttpAddFragmentToCache memorizza nella cache un frammento di dati con un nome specificato in base al quale può essere recuperato o aggiorna i dati memorizzati nella cache in un nome specificato.
HttpAddUrl Registra un URL specificato in modo che le richieste corrispondenti vengano indirizzate a una coda di richiesta dell'API DEL server HTTP specificata.
HttpAddUrlToUrlGroup Aggiunge l'URL specificato al gruppo DI URL identificato dall'ID gruppo DI URL.
HTTPAPI_EQUAL_VERSION Restituisce un valore diverso da zero se una struttura di HTTPAPI_VERSION è esattamente uguale a una combinazione di versione principale/secondaria specificata o zero in caso contrario.
HTTPAPI_GREATER_VERSION Restituisce un valore diverso da zero se una struttura HTTPAPI_VERSION è maggiore di una combinazione di versione principale/secondaria specificata o zero in caso contrario.
HTTPAPI_LESS_VERSION Restituisce un valore diverso da zero se una struttura di HTTPAPI_VERSION è minore di una combinazione di versione principale/secondaria specificata o zero in caso contrario.
HTTPAPI_VERSION_GREATER_OR_EQUAL Il HTTPAPI_VERSION_GREATER_OR_EQUAL restituisce un valore diverso da zero se una struttura di HTTPAPI_VERSION è maggiore o uguale a una combinazione di versione principale/secondaria specificata o zero in caso contrario.
HttpCancelHttpRequest La funzione HttpCancelHttpRequest annulla un reqest specificato.
HttpCloseRequestQueue Chiude l'handle alla coda di richiesta specificata creata da HttpCreateRequestQueue.
HttpCloseServerSession Elimina la sessione del server identificata dall'ID sessione del server.
HttpCloseUrlGroup Chiude il gruppo DI URL identificato dall'ID gruppo URL.
HttpCreateHttpHandle Crea una coda di richieste HTTP per l'applicazione chiamante e restituisce un handle.
HttpCreateRequestQueue Crea una nuova coda di richiesta o apre una coda di richieste esistente.
HttpCreateServerSession Crea una sessione server per la versione specificata.
HttpCreateUrlGroup Crea un gruppo di URL nella sessione del server specificata.
HttpDeclarePush Dichiara una relazione da risorsa a sottoresource da usare per un push del server HTTP. HTTP.sys quindi esegue un push server HTTP 2.0 per la risorsa specificata, se il protocollo sottostante, la connessione, il client e i criteri consentono l'operazione push.
HttpDelegateRequestEx Delega una richiesta dalla coda della richiesta di origine alla coda della richiesta di destinazione.
HttpDeleteServiceConfiguration Elimina i dati specificati, ad esempio indirizzi IP o certificati SSL, dall'archivio di configurazione dell'API SERVER HTTP, un record alla volta.
HttpFindUrlGroupId Recupera un ID gruppo URL per un URL e una coda di richieste.
HttpFlushResponseCache Rimuove dalla cache api del server HTTP associata a una determinata coda di richieste tutti i frammenti di risposta con un nome la cui parte del sito corrisponde a un urlPrefix specificato.
HttpInitialize La funzione HttpInitialize inizializza il driver API server HTTP, la avvia, se non è già stata avviata e alloca strutture di dati per l'applicazione chiamante per supportare la creazione della coda di risposta e altre operazioni.
HttpIsFeatureSupported Verifica se è supportata una determinata funzionalità.
HttpPrepareUrl Analizza, analizza e normalizza un URL Unicode o punycode non normalizzato in modo che sia sicuro e valido da usare in altre funzioni HTTP.
HttpQueryRequestQueueProperty Esegue query su una proprietà della coda di richiesta identificata dall'handle specificato.
HttpQueryServerSessionProperty Esegue query su una proprietà server nella sessione del server specificata.
HttpQueryServiceConfiguration Recupera uno o più record di configurazione DELL'API SERVER HTTP.
HttpQueryUrlGroupProperty Esegue una query su una proprietà nel gruppo DI URL specificato.
HttpReadFragmentFromCache La funzione HttpReadFragmentFromCache recupera un frammento di risposta con un nome specificato dalla cache dell'API HTTP Server.
HttpReceiveClientCertificate La funzione HttpReceiveClientCertificate viene usata da un'applicazione server per recuperare un certificato SSL client o un token di associazione del canale (CBT).
HttpReceiveHttpRequest Recupera la richiesta HTTP successiva disponibile dalla coda di richiesta specificata in modo sincrono o asincrono.
HttpReceiveRequestEntityBody Riceve dati aggiuntivi del corpo dell'entità per una richiesta HTTP specificata.
HttpRemoveUrl Causa l'arresto delle richieste di routing che corrispondono a una stringa UrlPrefix specificata a una coda di richiesta specificata.
HttpRemoveUrlFromUrlGroup Rimuove l'URL specificato dal gruppo identificato dall'ID gruppo URL.
HttpSendHttpResponse Invia una risposta HTTP alla richiesta HTTP specificata.
HttpSendResponseEntityBody Invia i dati del corpo dell'entità associati a una risposta HTTP.
HttpSetRequestProperty Imposta una nuova proprietà o modifica una proprietà esistente nella richiesta specificata.
HttpSetRequestQueueProperty Imposta una nuova proprietà o modifica una proprietà esistente nella coda della richiesta identificata dall'handle specificato.
HttpSetServerSessionProperty Imposta una nuova proprietà sessione server o modifica una proprietà esistente nella sessione del server specificata.
HttpSetServiceConfiguration Crea e imposta un record di configurazione per l'archivio di configurazione dell'API SERVER HTTP.
HttpSetUrlGroupProperty Imposta una nuova proprietà o modifica una proprietà esistente nel gruppo DI URL specificato.
HttpShutdownRequestQueue Arresta le richieste di accodamento per il processo di coda di richiesta specificato.
HttpTerminate Pulisce le risorse usate dall'API server HTTP per elaborare le chiamate da un'applicazione.
HttpUpdateServiceConfiguration Aggiornamenti un parametro di configurazione del servizio che specifica un certificato TLS (Transport Layer Security) in un record di configurazione all'interno dell'archivio di configurazione dell'API HTTP.
HttpWaitForDemandStart Attende l'arrivo di una nuova richiesta che può essere servita da un nuovo processo di coda di richieste.
HttpWaitForDisconnect Notifica all'applicazione quando la connessione a un client HTTP viene interrotta per qualsiasi motivo.
HttpWaitForDisconnectEx Questa funzione è un'estensione per HttpWaitForDisconnect.

Strutture

HTTP_BANDWIDTH_LIMIT_INFO La struttura HTTP_BANDWIDTH_LIMIT_INFO viene usata per impostare o eseguire query sul limite di limitazione della larghezza di banda. Questa struttura deve essere usata quando si imposta o si esegue una query su HttpServerBandwidthProperty in una sessione url Group o server.
HTTP_BINDING_INFO Usato per associare un gruppo DI URL a una coda di richieste.
HTTP_BYTE_RANGE La struttura HTTP_BYTE_RANGE viene usata per specificare un intervallo di byte all'interno di un frammento di risposta memorizzato nella cache, un file o un altro blocco di dati.
HTTP_CACHE_POLICY Usato per definire criteri di cache associati a un frammento di risposta memorizzato nella cache.
HTTP_CHANNEL_BIND_INFO HTTP_CHANNEL_BIND_INFO.
HTTP_CONNECTION_LIMIT_INFO Usato per impostare o eseguire query sul limite massimo di connessioni in sospeso per un gruppo di URL.
HTTP_COOKED_URL Contiene una stringa di richiesta url con codifica Unicode con codifica UTF-16 convalidata e con puntatori in esso e lunghezza degli elementi.
HTTP_DATA_CHUNK Rappresenta un singolo blocco di dati in memoria, in un file o nella cache del frammento di risposta dell'API SERVER HTTP.
HTTP_DELEGATE_REQUEST_PROPERTY_INFO Descrive informazioni aggiuntive sulle proprietà durante la delega di una richiesta.
HTTP_FLOWRATE_INFO Frequenza di trasferimento di una risposta.
HTTP_KNOWN_HEADER Contiene i valori di intestazione per un'intestazione nota da una richiesta HTTP o da una risposta HTTP.
HTTP_LISTEN_ENDPOINT_INFO Controlla se gli URL basati su IP devono essere in ascolto sull'indirizzo IP specifico o su un carattere jolly.
HTTP_LOG_DATA Contiene un valore che specifica il tipo dei dati di log.
HTTP_LOG_FIELDS_DATA Usato per passare i campi registrati per una risposta HTTP quando è abilitata la registrazione WC3.
HTTP_LOGGING_INFO Usato per abilitare la registrazione lato server in un gruppo di URL o in una sessione del server.
HTTP_MULTIPLE_KNOWN_HEADERS Specifica le intestazioni incluse in una risposta HTTP quando sono necessarie più intestazioni.
HTTP_PROPERTY_FLAGS Utilizzato dalle strutture di configurazione delle proprietà per abilitare o disabilitare una proprietà in un oggetto di configurazione durante l'impostazione delle configurazioni delle proprietà.
HTTP_QOS_SETTING_INFO Contiene informazioni su un'impostazione QOS.
HTTP_REQUEST_AUTH_INFO Contiene lo stato di autenticazione della richiesta con un handle al token client che il processo di ricezione può usare per rappresentare il client autenticato.
HTTP_REQUEST_CHANNEL_BIND_STATUS HTTP_REQUEST_CHANNEL_BIND_STATUS.
HTTP_REQUEST_HEADERS Contiene le intestazioni inviate con una richiesta HTTP.
HTTP_REQUEST_INFO Estende la struttura HTTP_REQUEST con informazioni aggiuntive sulla richiesta.
HTTP_REQUEST_PROPERTY_STREAM_ERROR La struttura HTTP_REQUEST_PROPERTY_STREAM_ERROR rappresenta un codice di errore del flusso HTTP/2 o HTTP/3.
HTTP_REQUEST_TIMING_INFO Contiene informazioni sulla quantità di tempo impiegato in ogni fase di elaborazione delle richieste.
HTTP_REQUEST_V1 Usa la struttura HTTP_REQUEST per restituire i dati associati a una richiesta specifica.
HTTP_REQUEST_V2 Estende la struttura della richiesta di HTTP_REQUEST_V1 con altre informazioni sulla richiesta.
HTTP_RESPONSE_HEADERS Contiene le intestazioni inviate con una risposta HTTP.
HTTP_RESPONSE_INFO Estende la struttura HTTP_RESPONSE con informazioni aggiuntive per la risposta.
HTTP_RESPONSE_V1 Contiene i dati associati a una risposta HTTP.
HTTP_RESPONSE_V2 Estende la struttura di risposta HTTP versione 1.0 con altre informazioni per la risposta.
HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS La struttura HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS contiene le informazioni per l'autenticazione di base in un gruppo di URL. Questa struttura è contenuta nella struttura HTTP_SERVER_AUTHENTICATION_INFO.
HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS Contiene le informazioni per l'autenticazione digest in un gruppo di URL.
HTTP_SERVER_AUTHENTICATION_INFO Usato per abilitare l'autenticazione lato server in un gruppo di URL o in una sessione del server.
HTTP_SERVICE_BINDING_A HTTP_SERVICE_BINDING_A.
HTTP_SERVICE_BINDING_BASE HTTP_SERVICE_BINDING_BASE.
HTTP_SERVICE_BINDING_W HTTP_SERVICE_BINDING_W.
HTTP_SERVICE_CONFIG_CACHE_SET Usato nel parametro pConfigInformation della funzione HttpSetServiceConfiguration.
HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM Consente di specificare un indirizzo IP da aggiungere o eliminare dall'elenco di indirizzi IP a cui è associato il servizio HTTP.
HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY Utilizzato da HttpQueryServiceConfiguration per restituire un elenco degli indirizzi IP (Internet Protocol) a cui è associato il servizio HTTP.
HTTP_SERVICE_CONFIG_SSL_CCS_KEY Funge da chiave in base alla quale identifica il record del certificato SSL che specifica che Http.sys deve consultare l'archivio certificati centralizzato (CCS) per trovare i certificati se la porta riceve un handshake TLS (Transport Layer Security).
HTTP_SERVICE_CONFIG_SSL_CCS_QUERY Specifica una configurazione SSL (Secure Sockets Layer) per eseguire una query per un record DELL'archivio certificati centralizzato (CCS) SSL sulla porta quando si chiama la funzione HttpQueryServiceConfiguration.
HTTP_SERVICE_CONFIG_SSL_CCS_SET Rappresenta il record del certificato SSL che specifica che Http.sys deve consultare l'archivio certificati centralizzato (CCS) per trovare i certificati se la porta riceve un handshake Transport Layer Security (TLS).
HTTP_SERVICE_CONFIG_SSL_KEY Funge da chiave in base alla quale viene identificato un determinato record di certificato SSL (Secure Sockets Layer).
HTTP_SERVICE_CONFIG_SSL_PARAM Definisce un record nell'archivio di configurazione SSL.
HTTP_SERVICE_CONFIG_SSL_QUERY Consente di specificare un record specifico per eseguire query nell'archivio di configurazione SSL.
HTTP_SERVICE_CONFIG_SSL_SET Usato per aggiungere un nuovo record all'archivio SSL o recuperare un record esistente da esso.
HTTP_SERVICE_CONFIG_SSL_SNI_KEY Funge da chiave in base alla quale un determinato record di certificato SNI (Secure Sockets Layer) viene identificato nell'archivio SNI SSL.
HTTP_SERVICE_CONFIG_SSL_SNI_QUERY Usato per specificare un determinato record di certificato SNI (Secure Sockets Layer) Per le query nell'archivio SNI SSL.
HTTP_SERVICE_CONFIG_SSL_SNI_SET Usato per aggiungere un nuovo record certificato SNI (Secure Sockets Layer) Server Name Indication (SNI) all'archivio SNI SSL o recuperare un record esistente da esso.
HTTP_SERVICE_CONFIG_TIMEOUT_SET Usato per impostare il valore di timeout a livello di API server HTTP.
HTTP_SERVICE_CONFIG_URLACL_KEY Usato per specificare un record di prenotazione specifico nell'archivio prenotazioni dello spazio dei nomi URL.
HTTP_SERVICE_CONFIG_URLACL_PARAM Consente di specificare le autorizzazioni associate a un determinato record nell'archivio prenotazioni dello spazio dei nomi URL.
HTTP_SERVICE_CONFIG_URLACL_QUERY Usato per specificare un record di prenotazione specifico su cui eseguire query nell'archivio prenotazioni dello spazio dei nomi URL.
HTTP_SERVICE_CONFIG_URLACL_SET Usato per aggiungere un nuovo record all'archivio prenotazioni URL o recuperare un record esistente da esso.
HTTP_SSL_CLIENT_CERT_INFO Contiene dati relativi a un certificato client SSL (Secure Sockets Layer) che può essere usato per determinare se il certificato è valido.
HTTP_SSL_INFO Contiene dati per una connessione che usa Secure Sockets Layer (SSL), ottenuti tramite l'handshake SSL.
HTTP_STATE_INFO Utilizzato per abilitare o disabilitare una sessione del server o un gruppo di URL.
HTTP_TIMEOUT_LIMIT_INFO Definisce i limiti di timeout di connessione specifici dell'applicazione.
HTTP_TRANSPORT_ADDRESS Specifica gli indirizzi (locali e remoti) usati per una determinata connessione HTTP.
HTTP_UNKNOWN_HEADER Contiene il nome e il valore per un'intestazione in una richiesta o risposta HTTP il cui nome non viene visualizzato nell'enumerazione .
HTTP_VERSION Definisce una versione del protocollo HTTP richiesta da una richiesta o una risposta.
HTTPAPI_VERSION Definisce la versione dell'API server HTTP.