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.

ObservaçãoFwpsQueryConnectionSioFormatRedirectRecords0 é uma versão específica de FwpsQueryConnectionSioFormatRedirectRecords. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.

 

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
STATUS_BUFFER_TOO_SMALL
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 .
STATUS_NOT_FOUND
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)

Usando o Redirecionamento de Associação ou Conexão

classifyFn