HttpCreateServerSession-Funktion (http.h)
Die HttpCreateServerSession-Funktion erstellt eine Serversitzung für die angegebene Version.
Syntax
HTTPAPI_LINKAGE ULONG HttpCreateServerSession(
[in] HTTPAPI_VERSION Version,
[out] PHTTP_SERVER_SESSION_ID ServerSessionId,
[in] ULONG Reserved
);
Parameter
[in] Version
Eine HTTPAPI_VERSION-Struktur, die die Version der Serversitzung angibt. Deklarieren Sie für Version 2.0 eine instance der Struktur, und legen Sie sie auf den vordefinierten Wert HTTPAPI_VERSION_2 fest, bevor Sie ihn an HttpCreateServerSession übergeben.
Die Version muss 2.0 sein. HttpCreateServerSession unterstützt keine Anforderungswarteschlangen der Version 1.0.
[out] ServerSessionId
Ein Zeiger auf die Variable, die die ID der Serversitzung empfängt.
[in] Reserved
Reserviert. Muss Null sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie NO_ERROR zurück.
Wenn die Funktion fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück.
| Wert | Bedeutung |
|---|---|
|
Die übergebene Version ist ungültig oder wird nicht unterstützt. |
|
Der pServerSessionId-Parameter ist NULL oder reserviert ist ungleich 0. |
Hinweise
Serversitzungen besitzen eine Reihe von URL-Gruppen. Dabei handelt es sich um Konfigurationscontainer der obersten Ebene für Konfigurationsinformationen, die für alle unter ihnen erstellten URL-Gruppen gelten. Weitere Informationen zum Konfigurieren einer Serversitzung finden Sie unter HttpSetServerSessionProperty.
Die HTTP-Server-API unterstützt keine asynchronen E/A-Vorgänge für Serversitzungen.
Wenn die Serversitzung nicht mehr erforderlich ist oder bevor die Anwendung beendet wird, muss die Anwendung die Serversitzung durch Aufrufen von HttpCloseServerSession löschen. Wenn eine Serversitzung gelöscht wird, werden auch alle zugeordneten URL-Gruppen automatisch gelöscht.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | http.h |
| Bibliothek | Httpapi.lib |
| DLL | Httpapi.dll |
Weitere Informationen
FUNKTIONEN DER HTTP-Server-API, Version 2.0