Función HttpSetRequestProperty (http.h)

La función HttpSetRequestProperty establece una nueva propiedad o modifica una propiedad existente en la solicitud especificada.

Sintaxis

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
);

Parámetros

[in] RequestQueueHandle

Identificador de la cola de solicitudes en la que se recibió la solicitud. Se crea una cola de solicitudes y su identificador devuelto por una llamada a la función HttpCreateRequestQueue .

[in] Id

Identificador opaco de la solicitud. Este identificador se encuentra en el miembro RequestId de la estructura HTTP_REQUEST devuelta por HttpReceiveHttpRequest.

[in] PropertyId

Miembro de la enumeración HTTP_REQUEST_PROPERTY que describe el tipo de propiedad que se establece. Debe ser una de las siguientes:

| Propiedad | Significado | | HttpRequestPropertyStreamError | Establece un error de secuencia en la solicitud. |

[in] Input

Puntero al búfer que contiene la información de la propiedad.

Debe apuntar a uno de los siguientes tipos de información de propiedad en función de la propiedad establecida.

| Propiedad | Tipo de configuración | | HttpRequestPropertyStreamError | estructura de HTTP_REQUEST_PROPERTY_STREAM_ERROR |

[in] InputPropertySize

Longitud, en bytes, del búfer al que apunta el parámetro Input .

[in] Overlapped

Para las llamadas asincrónicas, establezca pOverlapped para que apunte a una estructura SUPERPUESTA ; para llamadas sincrónicas, establéztelo en NULL.

Una llamada sincrónica se bloquea hasta que se completa la operación, mientras que una llamada asincrónica devuelve inmediatamente ERROR_IO_PENDING y la aplicación que realiza la llamada usa puertos de finalización getOverlappedResult o E/S para determinar cuándo se completa la operación. Para obtener más información sobre el uso de estructuras SUPERPUESTAs para la sincronización, vea Sincronización y entrada y salida superpuestas.

Valor devuelto

Si la función se realiza correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, devuelve un código de error del sistema.

Requisitos

Consulte también

HttpSetRequestQueueProperty