HttpCreateServerSession-Funktion (http.h)

  • Artikel

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
ERROR_REVISION_MISMATCH
 Die übergebene Version ist ungültig oder wird nicht unterstützt.
ERROR_INVALID_PARAMETER
 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

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty