HttpSetRequestQueueProperty-Funktion (http.h)

  • Artikel

Die HttpSetRequestQueueProperty-Funktion legt eine neue Eigenschaft fest oder ändert eine vorhandene Eigenschaft für die Durch das angegebene Handle identifizierte Anforderungswarteschlange.

Syntax

HTTPAPI_LINKAGE ULONG HttpSetRequestQueueProperty(
  [in] HANDLE               RequestQueueHandle,
  [in] HTTP_SERVER_PROPERTY Property,
  [in] PVOID                PropertyInformation,
  [in] ULONG                PropertyInformationLength,
  [in] ULONG                Reserved1,
  [in] PVOID                Reserved2
);

Parameter

[in] RequestQueueHandle

Das Handle für die Anforderungswarteschlange, für die die -Eigenschaft festgelegt wird. Eine Anforderungswarteschlange wird erstellt, und ihr Handle wird durch einen Aufruf der HttpCreateRequestQueue-Funktion zurückgegeben.

[in] Property

Ein Member der HTTP_SERVER_PROPERTY-Enumeration , die den festgelegten Eigenschaftstyp beschreibt. Dies muss einer der folgenden Sein:

Eigenschaft Bedeutung
HttpServer503VerbosityProperty
 Ändert oder legt den aktuellen Ausführlichkeitsgrad von 503 Antworten fest, die für die Anforderungswarteschlange generiert wurden.
HttpServerQueueLengthProperty
 Ändert oder legt den Grenzwert für die Anzahl der ausstehenden Anforderungen in der Anforderungswarteschlange fest.
HttpServerStateProperty
 Ändert oder legt den Zustand der Anforderungswarteschlange fest. Der Status muss entweder aktiv oder inaktiv sein.

[in] PropertyInformation

Ein Zeiger auf den Puffer, der die Eigenschafteninformationen enthält.

pPropertyInformation verweist basierend auf der festgelegten Eigenschaft auf einen der folgenden Eigenschaftsinformationstypen.

Eigenschaft Konfigurationstyp
HttpServerStateProperty HTTP_ENABLED_STATE Enumeration
HttpServerQueueLengthProperty ULONG
HttpServer503VerbosityProperty HTTP_503_RESPONSE_VERBOSITY Enumeration

[in] PropertyInformationLength

Die Länge des Puffers in Bytes, auf den der pPropertyInformation-Parameter verweist.

[in] Reserved1

Reserviert. Muss Null sein.

[in] Reserved2

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_INVALID_PARAMETER
 Der Reserved-Parameter ist nicht 0 oder der pReserved-Parameter ist nicht NULL.

Der im Property-Parameter angegebene Eigenschaftentyp wird für Anforderungswarteschlangen nicht unterstützt.

Der pPropertyInformation-Parameter ist NULL.

Der PropertyInformationLength-Parameter ist 0.

Die Anwendung verfügt nicht über die Berechtigung, Eigenschaften für die Anforderungswarteschlange festzulegen. Nur die Anwendung, die die Anforderungswarteschlange erstellt hat, kann die Eigenschaften festlegen.
ERROR_NOT_SUPPORTED
 Das Handle für die Anforderungswarteschlange ist ein HTTP-Handle der Version 1.0. Die Eigenschaftenverwaltung wird nur in HTTP-Anforderungswarteschlangen der Version 2.0 oder höher unterstützt.

Anforderungen

Anforderung Wert
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

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpShutdownRequestQueue