大网数据广告活动
Web服务器与PHP

HttpQueryRequestProperty

· 52CE 我爱测

Gives an application access to find-grained information about a request.

Gives an application access to find-grained information about a request. Mostly connection flow statistics, but also the Server Name Indication (SNI—presents the server domain name requested by the client to the server so that it can select the correct certificate, among other reasons), and other traits of the underlying TLS connection (when applicable).

The HTTP_REQUEST structure gets filled in with the information that pretty much every server application will need in order to respond to a request, and HttpQueryRequestProperty is for getting useful diagnostic data about a request, or more detailed information where it's going to be really necessary. Most applications aren't concerned with the precise breakdown of timings for API calls, but very large or very performance-driven applications or teams might want those details for better debugging. But be aware that there's a cost associated with gathering or retrieving most of the data covered by HttpQueryRequestProperty.

Whereas HttpSetRequestProperty works on just two values in HTTP_REQUEST_PROPERTY, the HttpQueryRequestProperty function works on all of them.

See Remarks for info about how to call the function.

Syntax

HTTPAPI_LINKAGE ULONG WINAPI
HttpQueryRequestProperty(
  _In_ HANDLE RequestQueueHandle,
  _In_ HTTP_OPAQUE_ID Id,
  _In_ HTTP_REQUEST_PROPERTY PropertyId,
  _In_reads_bytes_opt_(QualifierSize) VOID *Qualifier,
  _In_ ULONG QualifierSize,
  _Out_writes_bytes_to_opt_(OutputBufferSize, *BytesReturned) PVOID Output,
  _In_ ULONG OutputBufferSize,
  _Out_opt_ PULONG BytesReturned,
  _In_opt_ LPOVERLAPPED Overlapped
);

Parameters

RequestQueueHandle

Type: _In_ HANDLE

The handle to the request queue where the request being queried was received.

Id

Type: _In_ HTTP_OPAQUE_ID

The opaque ID of the request.

PropertyId

Type: _In_ HTTP_REQUEST_PROPERTY

A member of the HTTP_REQUEST_PROPERTY enumeration describing the property type that's set. The enumeration includes notes about supported properties and how to enable them.

Qualifier

Type: _In_reads_bytes_opt_(QualifierSize) VOID *

An optional parameter required for some values of PropertyId to identify bounds on what data you're requesting. For the Stats options, it can be used to define the window of time to look back for connection statistics.

QualifierSize

Type: _In_ ULONG

The size of the structure passed in Qualifier. If Qualifier is NULL, then set this to 0.

Output

Type: _Out_writes_bytes_to_opt_(OutputBufferSize, *BytesReturned) PVOID

Receives the contents of the property requested. You're responsible for allocating and freeing this buffer. For many properties, this is a fixed-size buffer depending on the property requested. See HTTP_REQUEST_PROPERTY for the specifics of a given property.

When a property returns a variable-length buffer, you can probe for the size of buffer needed by leaving this parameter NULL, and passing in a pointer for BytesReturned. For more details, see HTTP_REQUEST_PROPERTY.

OutputBufferSize

Type: _In_ ULONG

The size of the buffer passed in Output, or 0 if it's NULL.

BytesReturned

Type: _Out_opt_ PULONG

Returns the number of bytes written to Output. Or, for variable-length properties, can return the size of buffer needed if Output wasn't large enough. For variable-length properties, you should call first with Output set to NULL so that you can retrieve through BytesReturned the buffer size you need, then allocate that amount of memory, then retry the query.

Overlapped

Type: _In_opt_ LPOVERLAPPED

While you can provide an OVERLAPPED structure for asynchronous operation, setting this parameter is not a guarantee that the API will run asynchronously; most operations on this API are always synchronous. The event in this structure is used only if the API returns ERROR_IO_PENDING.

Return value

Type: ULONG

If the function succeeds, then the return value is ERROR_SUCCESS. If an OVERLAPPED structure is provided, and the function runs asynchronously, then ERROR_IO_PENDING will be returned, and is not an error.

If the function fails, then the return value is one of the following error codes:

Return code Description
ERROR_INVALID_PARAMETER One or more of the arguments is invalid.
ERROR_INVALID_FUNCTION The request doesn't support the property you've queried.
ERROR_MORE_DATA The size of the output buffer is insufficient, allocate a larger buffer for the next request.
Other Check the system error codes defined in WinError.h

Remarks

This function does not have an associated header file or library file. Your application can call LoadLibrary with the DLL name (httpapi.dll) to obtain a module handle. It can then call GetProcAddress with the module handle and the name of this function to get the function address.

Requirements

   
Minimum supported client Windows 10, version 1709 [desktop apps only]
Minimum supported server Windows Server, version 1709 [desktop apps only]
Target Platform Windows
Header None
Library None
DLL httpapi.dll

See also

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 04/25/2025
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。