通过

httpSetRequestProperty 函数 (http.h)

  • 项目

HttpSetRequestProperty 函数针对指定请求设置新属性或修改现有属性。

语法

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

parameters

[in] RequestQueueHandle

接收请求的请求队列的句柄。 创建请求队列，并通过调用 HttpCreateRequestQueue 函数返回其句柄。

[in] Id

请求的不透明 ID。 此 ID 位于 HttpReceiveHttpRequest 返回的 HTTP_REQUEST 结构的 RequestId 成员中。

[in] PropertyId

描述所设置的属性类型的 HTTP_REQUEST_PROPERTY 枚举的成员。 这必须是下列项之一：

| 财产 | 含义 | |HttpRequestPropertyStreamError |对请求设置流错误。 |

[in] Input

指向包含属性信息的缓冲区的指针。

它必须基于所设置的属性指向以下属性信息类型之一。

| 财产 | 配置类型 | |HttpRequestPropertyStreamError | HTTP_REQUEST_PROPERTY_STREAM_ERROR 结构 |

[in] InputPropertySize

Input 参数指向的缓冲区的长度（以字节为单位）。

[in] Overlapped

对于异步调用，请将 pOverlapped 设置为指向 OVERLAPPED 结构;对于同步调用，请将其设置为 NULL。

同步调用会一直阻塞，直到操作完成，而异步调用会立即返回 ERROR_IO_PENDING ，然后调用应用程序使用 GetOverlappedResult 或 I/O 完成端口来确定操作何时完成。 有关使用 OVERLAPPED 结构进行同步的详细信息，请参阅 同步和重叠输入和输出。

返回值

如果函数成功，则返回 ERROR_SUCCESS。

如果函数失败，它将返回 系统错误代码。

要求

   
目标平台 Windows
标头 http.h
Library Httpapi.lib
DLL Httpapi.dll

另请参阅

HttpSetRequestQueueProperty