Funzione HttpSetRequestProperty (http.h)
La funzione HttpSetRequestProperty imposta una nuova proprietà o modifica una proprietà esistente nella richiesta specificata.
Sintassi
HTTPAPI_LINKAGE ULONG HttpSetRequestProperty(
[in] HANDLE RequestQueueHandle,
[in] HTTP_OPAQUE_ID Id,
[in] HTTP_REQUEST_PROPERTY PropertyId,
[in] PVOID Input,
[in] ULONG InputPropertySize,
[in] LPOVERLAPPED Overlapped
);
Parametri
[in] RequestQueueHandle
Handle per la coda di richieste in cui è stata ricevuta la richiesta. Viene creata una coda di richieste e il relativo handle restituito da una chiamata alla funzione HttpCreateRequestQueue .
[in] Id
ID opaco della richiesta. Questo ID si trova nel membro RequestId della struttura HTTP_REQUEST restituita da HttpReceiveHttpRequest.
[in] PropertyId
Membro dell'enumerazione HTTP_REQUEST_PROPERTY che descrive il tipo di proprietà impostato. Deve essere uno dei seguenti:
| Proprietà | Significato | | HttpRequestPropertyStreamError | Imposta un errore di flusso sulla richiesta. |
[in] Input
Puntatore al buffer che contiene le informazioni sulla proprietà.
Deve puntare a uno dei tipi di informazioni sulle proprietà seguenti in base alla proprietà impostata.
| Proprietà | Tipo di configurazione | | HttpRequestPropertyStreamError | struttura HTTP_REQUEST_PROPERTY_STREAM_ERROR |
[in] InputPropertySize
Lunghezza, in byte, del buffer a cui punta il parametro Input .
[in] Overlapped
Per le chiamate asincrone, impostare pOverlapped in modo che punti a una struttura OVERLAPPED ; per le chiamate sincrone, impostarlo su NULL.
Una chiamata sincrona si blocca fino al completamento dell'operazione, mentre una chiamata asincrona restituisce immediatamente ERROR_IO_PENDING e l'applicazione chiamante usa quindi le porte di completamento GetOverlappedResult o I/O per determinare quando l'operazione viene completata. Per altre informazioni sull'uso di strutture OVERLAPPED per la sincronizzazione, vedere Sincronizzazione e input e output sovrapposti.
Valore restituito
Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.
Se la funzione ha esito negativo, restituisce un codice di errore di sistema.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | http.h |
| Libreria | Httpapi.lib |
| DLL | Httpapi.dll |