HttpSetRequestQueueProperty-Funktion (http.h)

Artikel
08/24/2023

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.

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

Freigeben über