Função FwpsQueryConnectionSioFormatRedirectRecords0 (fwpsk.h)
A função FwpsQueryConnectionSioFormatRedirectRecords0 retorna os registros de redirecionamento de conexão para uma conexão redirecionada. Para obter mais informações sobre o redirecionamento, consulte Usando Associação ou Redirecionamento de Conexão.
Sintaxe
NTSTATUS FwpsQueryConnectionSioFormatRedirectRecords0(
[in] HANDLE RedirectRecords,
[out, optional] PVOID OutputBuffer,
[in] SIZE_T OutputBufferLength,
[out, optional] PSIZE_T BytesTransferred
);
Parâmetros
[in] RedirectRecords
O identificador de registros de redirecionamento que a função de texto explicativo ALE_CONNECT_REDIRECT recebeu no parâmetro inMetaValues de sua função classifyFn . Esse identificador pode ser encontrado no membro redirectRecords da estrutura FWPS_INCOMING_METADATA_VALUES0 .
Um registro de redirecionamento do WFP é um buffer de dados opacos que o WFP deve definir em uma conexão de proxy de saída para que a conexão redirecionada e a conexão original estejam logicamente relacionadas.
[out, optional] OutputBuffer
Um ponteiro para um buffer de saída que recebe os registros de redirecionamento. O buffer deve ser alinhado ao ponteiro.
[in] OutputBufferLength
O tamanho, em bytes, do buffer de saída.
[out, optional] BytesTransferred
Um ponteiro para uma variável que recebe o número de bytes que foram transferidos. Se o valor retornado for STATUS_BUFFER_TOO_SMALL, esse parâmetro receberá o tamanho do buffer necessário.
Retornar valor
Retorna um valor NTSTATUS, como um dos seguintes.
Código de retorno | Descrição |
---|---|
|
O buffer de saída era muito pequeno para conter todos os bytes a serem transferidos. Falha na transferência de dados e o tamanho do buffer necessário pode ser encontrado no parâmetro BytesTransferred . |
|
O parâmetro RedirectRecords era nulo. |
Comentários
A função FwpsQueryConnectionSioFormatRedirectRecords0 aplica-se somente a proxies locais.
Para obter mais informações sobre o redirecionamento, consulte Usando Associação ou Redirecionamento de Conexão.
A função FwpsQueryConnectionSioFormatRedirectRecords0 foi projetada para ser usada por um driver de texto explicativo de redirecionamento de conexão WFP que não aceita a conexão redirecionada até que tenha verificado que ele é capaz de se conectar ao ponto de extremidade remoto real. Para fazer isso, o driver de texto explicativo aguarda a solicitação de conexão redirecionada na camada FWPS_LAYER_ALE_CONNECT_REDIRECT_V4 ou FWPS_LAYER_ALE_CONNECT_REDIRECT_V6 e chama FwpsQueryConnectionSioFormatRedirectRecords0 para recuperar os registros de redirecionamento de conexão, que o driver de texto explicativo envia para o proxy a ser usado em uma chamada para SIO_SET_WFP_CONNECTION_REDIRECT_RECORDS.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows 7 |
Servidor mínimo com suporte | Windows Server 2008 R2 |
Plataforma de Destino | Universal |
Cabeçalho | fwpsk.h (inclua Fwpsk.h) |
Biblioteca | Fwpkclnt.lib |
IRQL | <=DISPATCH_LEVEL |
Confira também
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)
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte:Enviar e exibir comentários de