Freigeben über


Versionsverwaltung (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 objektbezogener Versionsverwaltung können Anwendungen anwendungsspezifische Versionsinformationen bereitstellen. Anwendungen können automatisch die richtige Version von Strukturen für das Betriebssystem aufrufen, auf dem sie ausgeführt wird.

Anforderungswarteschlangen

Ab der HTTP Server Version 2.0-API werden Anforderungswarteschlangen mit HttpCreateRequestQueue erstellt, sodass 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 mithilfe von 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 Warteschlange für benannte Anforderungen .

Object-Scoped Versionierung

In Version 1.0 stellt die Anwendung die HTTP-Server-API-Version im Aufruf von HttpInitialize bereit. Die Versionsinformationen werden nur von der ersten Anwendung akzeptiert, die HttpInitialize aufgerufen hat, und auf alle HTTP-Server-API-Anwendungen im selben Prozess angewendet. Ab der API der Version 2.0 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 Versionsparameter übergeben, wenn die Anforderungswarteschlange oder Serversitzung von HttpCreateRequestQueue oder HttpCreateServerSession erstellt wird. Wenn die Anforderungswarteschlange mit httpCreateHttpHandle version 1.0 erstellt wird, wird sie automatisch als Version 1.0 markiert. Anwendungen der Version 1.0 und 2.0 können im selben 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 im Code verwenden. Stattdessen sollten sie HTTP_REQUEST verwenden, um die richtige Version basierend auf der Version der Anforderungswarteschlange zu erhalten, für die die Anforderung empfangen wurde. Beachten Sie außerdem, dass die Größe der HTTP_REQUEST Struktur auf der Version des Betriebssystems basiert, unter der der Code kompiliert wird.