FwpsQueryConnectionSioFormatRedirectRecords0 - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// fwpsk.h
NTSTATUS FwpsQueryConnectionSioFormatRedirectRecords0(
[in] HANDLE RedirectRecords,
[out, optional] PVOID OutputBuffer,
[in] SIZE_T OutputBufferLength,
[out, optional] PSIZE_T BytesTransferred
);
View the official Windows Driver Kit DDI referenceNo description available.
The FwpsQueryConnectionSioFormatRedirectRecords0 function returns the connection redirect records for a redirected connection. For more information about redirection, see Using Bind or Connect Redirection.
Note FwpsQueryConnectionSioFormatRedirectRecords0 is a specific version of FwpsQueryConnectionSioFormatRedirectRecords. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.
RedirectRecords [in]The redirect records handle that the ALE_CONNECT_REDIRECT callout function received in the inMetaValues parameter of its classifyFn function. This handle can be found in the redirectRecords member of the FWPS_INCOMING_METADATA_VALUES0 structure.
A WFP redirect record is a buffer of opaque data that WFP must set on an outbound proxy connection so that the redirected connection and the original connection are logically related.
OutputBuffer [out, optional]A pointer to an output buffer that receives the redirect records. The buffer must be pointer-aligned.
OutputBufferLength [in]The size, in bytes, of the output buffer.
BytesTransferred [out, optional]A pointer to a variable that receives the number of bytes that were transferred. If the return value is STATUS_BUFFER_TOO_SMALL, this parameter receives the required buffer size.
Returns an NTSTATUS value such as one of the following.
| Return code | Description |
|---|---|
| STATUS_BUFFER_TOO_SMALL | The output buffer was too small to contain all of the bytes to be transferred. The data transfer failed, and the required buffer size can be found in the BytesTransferred parameter. |
| STATUS_NOT_FOUND | The RedirectRecords parameter was null. |
The FwpsQueryConnectionSioFormatRedirectRecords0 function applies only to local proxies.
For more information about redirection, see Using Bind or Connect Redirection.
The FwpsQueryConnectionSioFormatRedirectRecords0 function is designed to be used by a WFP connection redirection callout driver that doesn't accept the redirected connection until it has verified that it is able to connect to the actual remote endpoint. To do this, the callout driver pends the redirected connection request at the FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 or FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 layer and calls FwpsQueryConnectionSioFormatRedirectRecords0 to retrieve the connection redirect records, which the callout driver then sends to the proxy to be used in a call to SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS.
SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS (SDK)
SIO_QUERY_WFP_CONNECTION_REDIRECT_RECORDS (WDK)
SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (SDK)
SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS (WDK)
Using Bind or Connect Redirection