Funzione HttpSetRequestQueueProperty (http.h)

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.

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