Versionierung (HTTP-Server-API)
Die HTTP Server Version 2.0-API macht die Anforderungswarteschlangen und URL-Zuordnungen der Version 1.0 mit der Anforderungswarteschlange veraltet. Mit der objektbezogenen Versionsangabe können Anwendungen anwendungsspezifische Versionsinformationen bereitstellen. Anwendungen können automatisch die richtige Version der Strukturen für das Betriebssystem aufrufen, unter dem sie ausgeführt wird.
Anforderungswarteschlangen
Ab http Server Version 2.0 API werden Anforderungswarteschlangen mit HttpCreateRequestQueue erstellt, wodurch die HttpCreateHttpHandle-Funktion der Version 1.0 veraltet ist. URL-Gruppen werden in Version 2.0 mit der HttpCreateUrlGroup-Funktion eingeführt. URLs werden der Gruppe mit httpAddUrlToUrlGroup hinzugefügt, wodurch die HttpAddUrl-Funktion der Version 1.0 veraltet ist. URL-Gruppen der Version 2.0 dürfen nicht mit Anforderungswarteschlangen der Version 1.0 verwendet werden.
Ab Version 2.0 sind die folgenden Funktionen der Version 1.0 veraltet und können nicht mit Anforderungswarteschlangen der Version 2.0 verwendet werden:
Weitere Informationen zum Konfigurieren von URL-Gruppen finden Sie im Thema Konfigurieren der URL-Gruppe. Weitere Informationen zu Anforderungswarteschlangen der Version 2.0 finden Sie im Thema Benannte Anforderungswarteschlange.
Object-Scoped Versionierung
In Version 1.0 stellt die Anwendung die HTTP-Server-API-Version im Aufruf von HttpInitializebereit. Die Versionsinformationen werden nur von der ersten Anwendung akzeptiert, die HttpInitialize aufgerufen hat, und werden auf alle HTTP-Server-API-Anwendungen im selben Prozess angewendet. Ab version 2.0 API werden die globalen Versionsinformationen, die im Aufruf von HttpInitialize bereitgestellt werden, nicht verwendet. Bei Anwendungen der Version 2.0 wird die HTTP-Server-API-Version im Version-Parameter übergeben, wenn die Anforderungswarteschlange oder Serversitzung von HttpCreateRequestQueue oder HttpCreateServerSessionerstellt wird. Wenn die Anforderungswarteschlange mit der Version 1.0 HttpCreateHttpHandleerstellt wird, wird sie automatisch als Version 1.0 markiert. Anwendungen der Versionen 1.0 und 2.0 können im gleichen Prozess ausgeführt werden.
Die HTTP _ REQUEST- und HTTP _ RESPONSE-Strukturen werden aktualisiert, um Authentifizierungsinformationen in die HTTP Server Version 2.0-API aufzunehmen. HTTP _ REQUEST _ V1 und HTTP REQUEST _ _ V2 sind spezifisch für die Version der API, die von der Anwendung verwendet wird. Anwendungen sollten diese Strukturen jedoch nicht direkt in ihrem Code verwenden. Stattdessen sollten sie HTTP _ REQUEST verwenden, um die richtige Version basierend auf der Version der Anforderungswarteschlange abzurufen, in der die Anforderung empfangen wurde. Beachten Sie außerdem, dass die Größe der HTTP _ REQUEST-Struktur auf der Version des Betriebssystems basiert, unter dem der Code kompiliert wird.