HttpQueryRequestQueueProperty-Funktion (http.h)
Die HttpQueryRequestQueueProperty-Funktion fragt eine Eigenschaft der Anforderungswarteschlange ab, die durch das angegebene Handle identifiziert wird.
Syntax
HTTPAPI_LINKAGE ULONG HttpQueryRequestQueueProperty(
HANDLE RequestQueueHandle,
[in] HTTP_SERVER_PROPERTY Property,
[out] PVOID PropertyInformation,
[in] ULONG PropertyInformationLength,
[in] ULONG Reserved1,
[out, optional] PULONG ReturnLength,
[in] PVOID Reserved2
);
Parameter
RequestQueueHandle
[in] Property
Ein Element der HTTP_SERVER_PROPERTY-Enumeration , das den festgelegten Eigenschaftentyp beschreibt. Folgende Möglichkeiten stehen zur Auswahl:
[out] PropertyInformation
Ein Zeiger auf den Puffer, der die Eigenschafteninformationen empfängt.
pPropertyInformation verweist basierend auf der festgelegten Eigenschaft auf einen der folgenden Eigenschaftsinformationswerte.
Eigenschaft | Wert |
---|---|
HttpServerStateProperty | HTTP_ENABLED_STATE (Enumerationsmember) |
HttpServerQueueLengthProperty | ULONG |
HttpServer503VerbosityProperty | HTTP_503_RESPONSE_VERBOSITY (Enumerationsmember) |
[in] PropertyInformationLength
Die Länge des Puffers in Bytes, auf den der pPropertyInformation-Parameter verweist.
[in] Reserved1
Reserviert. Muss Null sein.
[out, optional] ReturnLength
Die Zahl in Bytes, die im pPropertyInformation-Puffer zurückgegeben wird, wenn nicht NULL.
Wenn der Ausgabepuffer zu klein ist, schlägt der Aufruf mit dem Rückgabewert ERROR_MORE_DATA fehl. Der Wert, auf den pReturnLength verweist, kann verwendet werden, um die Mindestlänge des Puffers zu bestimmen, der für den erfolgreichen Aufruf erforderlich ist.
[in] Reserved2
Dieser Parameter ist reserviert und 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 |
---|---|
|
Der Reserved-Parameter ist nicht 0 oder der pReserved-Parameter ist nicht NULL.
Der im Property-Parameter angegebene Eigenschaftentyp wird in Anforderungswarteschlangen nicht unterstützt. Der pPropertyInformation-Parameter ist NULL. Der PropertyInformationLength-Parameter ist 0. Die Anwendung verfügt nicht über die Berechtigung zum Öffnen der Anforderungswarteschlange. |
|
Die Größe des Puffers, auf den der pPropertyInformation-Parameter verweist, ist zu klein, um die Eigenschafteninformationen zu empfangen. Rufen Sie die Funktion erneut mit einem Puffer auf, der mindestens so groß ist wie die Größe, auf die pReturnLength beim Beenden verweist. |
|
Das Handle für die Anforderungswarteschlange ist ein HTTP-Handle der Version 1.0. Die Eigenschaftenverwaltung wird nur für Anforderungswarteschlangen mit HTTP-Version 2.0 und höher unterstützt. |
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 |