Funzione HttpSetRequestQueueProperty (http.h)

Articolo
08/24/2023

La funzione HttpSetRequestQueueProperty imposta una nuova proprietà o modifica una proprietà esistente nella coda di richiesta identificata dall'handle specificato.

Sintassi

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

Parametri

[in] RequestQueueHandle

Handle alla coda della richiesta in cui è impostata la proprietà. Viene creata una coda di richieste e il relativo handle restituito da una chiamata alla funzione HttpCreateRequestQueue .

[in] Property

Membro dell'enumerazione HTTP_SERVER_PROPERTY che descrive il tipo di proprietà impostato. Questo deve essere uno dei seguenti:

Proprietà	Significato
HttpServer503VerbosityProperty	Modifica o imposta il livello di verbosità corrente di 503 risposte generate per la coda della richiesta.
HttpServerQueueLengthProperty	Modifica o imposta il limite sul numero di richieste in sospeso nella coda della richiesta.
HttpServerStateProperty	Modifica o imposta lo stato della coda della richiesta. Lo stato deve essere attivo o inattivo.

[in] PropertyInformation

Puntatore al buffer contenente le informazioni sulla proprietà.

pPropertyInformation punta a uno dei tipi di informazioni sulle proprietà seguenti in base alla proprietà impostata.

Proprietà	Tipo configurazione
HttpServerStateProperty	enumerazione HTTP_ENABLED_STATE
HttpServerQueueLengthProperty	ULONG
HttpServer503VerbosityProperty	enumerazione HTTP_503_RESPONSE_VERBOSITY

[in] PropertyInformationLength

Lunghezza, in byte, del buffer a cui fa riferimento il parametro pPropertyInformation .

[in] Reserved1

Riservato. Deve essere zero.

[in] Reserved2

Riservato. Deve essere NULL.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR.

Se la funzione ha esito negativo, restituisce uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_PARAMETER	Il parametro Riservato non è zero o il parametro pReserved non è NULL. Il tipo di proprietà specificato nel parametro Property non è supportato per le code delle richieste. Il parametro pPropertyInformation è NULL. Il parametro PropertyInformationLength è zero. L'applicazione non dispone dell'autorizzazione per impostare le proprietà nella coda della richiesta. Solo l'applicazione che ha creato la coda della richiesta può impostare le proprietà.
ERROR_NOT_SUPPORTED	L'handle alla coda della richiesta è un handle HTTP versione 1.0. La gestione delle proprietà è supportata solo nelle code di richieste HTTP versione 2.0 o successiva.

Valore

Significato

ERROR_INVALID_PARAMETER

Il parametro Riservato non è zero o il parametro pReserved non è NULL.

Il tipo di proprietà specificato nel parametro Property non è supportato per le code delle richieste.

Il parametro pPropertyInformation è NULL.

Il parametro PropertyInformationLength è zero.

L'applicazione non dispone dell'autorizzazione per impostare le proprietà nella coda della richiesta. Solo l'applicazione che ha creato la coda della richiesta può impostare le proprietà.

ERROR_NOT_SUPPORTED

L'handle alla coda della richiesta è un handle HTTP versione 1.0. La gestione delle proprietà è supportata solo nelle code di richieste HTTP versione 2.0 o successiva.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	http.h
Libreria	Httpapi.lib
DLL	Httpapi.dll

Vedi anche

Funzioni API SERVER HTTP versione 2.0

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpShutdownRequestQueue

Condividi tramite