Función HttpQueryRequestQueueProperty (http.h)
La función HttpQueryRequestQueueProperty consulta una propiedad de la cola de solicitudes identificada por el identificador especificado.
Sintaxis
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
);
Parámetros
RequestQueueHandle
[in] Property
Miembro de la enumeración HTTP_SERVER_PROPERTY que describe el tipo de propiedad que se establece. Puede ser uno de los siguientes:
[out] PropertyInformation
Puntero al búfer que recibe la información de la propiedad.
pPropertyInformation apunta a uno de los siguientes valores de información de propiedad basados en la propiedad establecida.
Propiedad | Valor |
---|---|
HttpServerStateProperty | HTTP_ENABLED_STATE (miembro de enumeración) |
HttpServerQueueLengthProperty | ULONG |
HttpServer503VerbosityProperty | HTTP_503_RESPONSE_VERBOSITY (miembro de enumeración) |
[in] PropertyInformationLength
Longitud, en bytes, del búfer al que apunta el parámetro pPropertyInformation.
[in] Reserved1
Reservado. Debe ser cero.
[out, optional] ReturnLength
Número, en bytes, devuelto en el búfer de pPropertyInformation si no NULL.
Si el búfer de salida es demasiado pequeño, se produce un error en la llamada con un valor devuelto de ERROR_MORE_DATA. El valor al que apunta pReturnLength se puede usar para determinar la longitud mínima del búfer necesario para que la llamada se realice correctamente.
[in] Reserved2
Este parámetro está reservado y debe ser NULL.
Valor devuelto
Si la función se ejecuta correctamente, devuelve NO_ERROR.
Si se produce un error en la función, devuelve uno de los siguientes códigos de error.
Valor | Significado |
---|---|
|
El parámetro Reserved no es cero o el parámetro pReserved no es NULL.
El tipo de propiedad especificado en el parámetro Property no se admite en las colas de solicitudes. El parámetro pPropertyInformation es NULL. El parámetro PropertyInformationLength es cero. La aplicación no tiene permiso para abrir la cola de solicitudes. |
|
El tamaño, en bytes, del búfer al que apunta el parámetro pPropertyInformation es demasiado pequeño para recibir la información de propiedad. Vuelva a llamar a la función con un búfer al menos tan grande como el tamaño al que apunta pReturnLength al salir. |
|
El identificador de la cola de solicitudes es un identificador http versión 1.0. La administración de propiedades solo se admite para las colas de solicitudes HTTP versión 2.0 y posteriores. |
Requisitos
Requisito | Valor |
---|---|
cliente mínimo admitido | Windows Vista [solo aplicaciones de escritorio] |
servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
de la plataforma de destino de | Windows |
encabezado de | http.h |
biblioteca de | Httpapi.lib |
DLL de | Httpapi.dll |