Funzione HttpSetRequestProperty (http.h)

Articolo
08/24/2023

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:

[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.

[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

Vedi anche

HttpSetRequestQueueProperty

Share via