HttpInitialize-Funktion (http.h)

  • Artikel

Die HttpInitialize-Funktion initialisiert den HTTP-Server-API-Treiber, startet ihn, sofern er noch nicht gestartet wurde, und ordnet datenstrukturen für die aufrufende Anwendung zu, um die Erstellung von Antwortwarteschlangen und andere Vorgänge zu unterstützen. Rufen Sie diese Funktion auf, bevor Sie andere Funktionen in der HTTP-Server-API aufrufen.

Syntax

HTTPAPI_LINKAGE ULONG HttpInitialize(
  [in]      HTTPAPI_VERSION Version,
  [in]      ULONG           Flags,
  [in, out] PVOID           pReserved
);

Parameter

[in] Version

HTTP-Version. Dieser Parameter ist eine HTTPAPI_VERSION-Struktur . Deklarieren Sie für die aktuelle Version eine instance der Struktur, und legen Sie sie auf den vordefinierten Wert HTTPAPI_VERSION_1 fest, bevor Sie ihn an HttpInitialize übergeben.

[in] Flags

Initialisierungsoptionen, die einen oder beide der folgenden Werte enthalten können.

Wert Bedeutung
HTTP_INITIALIZE_CONFIG
 Führen Sie die Initialisierung für Anwendungen aus, die die HTTP-Konfigurationsfunktionen HttpSetServiceConfiguration, HttpQueryServiceConfiguration, HttpDeleteServiceConfiguration und HttpIsFeatureSupported verwenden.
HTTP_INITIALIZE_SERVER
 Führen Sie die Initialisierung für Anwendungen aus, die die HTTP-Server-API verwenden.

[in, out] pReserved

Dieser Parameter ist reserviert und muss NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert Bedeutung
ERROR_INVALID_PARAMETER
 Der Flags-Parameter enthält einen nicht unterstützten Wert.
Andere
 Ein in WinError.h definierter Systemfehlercode .

Hinweise

Rufen Sie HttpTerminate auf , wenn die Anwendung abgeschlossen ist. Alle flags, die im Flags-Parameter an HttpInitialize übergeben wurden, müssen auch an HttpTerminate übergeben werden. Eine Anwendung kann HttpInitialize wiederholt aufrufen, vorausgesetzt, jeder Aufruf von HttpInitialize wird später durch einen entsprechenden Aufruf von HttpTerminate abgeglichen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile http.h
Bibliothek Httpapi.lib
DLL Httpapi.dll

Weitere Informationen