Função FwpsRedirectHandleCreate0 (fwpsk.h)

Artigo
02/07/2025

A função FwpsRedirectHandleCreate0 cria um identificador que as funções de redirecionamento de conexão podem usar para redirecionar conexões para um processo local. Para obter mais informações sobre o redirecionamento, consulte Usando ode Redirecionamento de Associação ou Conexão.

ObservaçãoFwpsRedirectHandleCreate0 é uma versão específica do FwpsRedirectHandleCreate. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.

Sintaxe

NTSTATUS FwpsRedirectHandleCreate0(
  const GUID *providerGuid,
  UINT32     flags,
  HANDLE     *redirectHandle
);

Parâmetros

providerGuid

O GUID do provedor.

flags

Reservado. Definido como zero.

redirectHandle

Um ponteiro para a variável que recebe o identificador.

Valor de retorno

A função FwpsRedirectHandleCreate0 retorna um dos seguintes códigos NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	Um identificador de redirecionamento foi retornado com êxito. A variável que o redirectHandle aponta para conter o identificador.
Outros códigos de status	Ocorreu um erro.

Observações

Um driver de texto explicativo chama a função FwpsRedirectHandleCreate0 para criar um identificador que pode ser usado para redirecionar conexões.

Para obter mais informações sobre o redirecionamento, consulte Usando ode Redirecionamento de Associação ou Conexão.

O driver de texto explicativo deve chamar FwpsRedirectHandleCreate0 uma vez e armazenar o identificador em cache para que ele possa reutilizar o identificador.

Antes que um texto explicativo de redirecionamento de conexão ALE (Application Layer Enforcement) possa redirecionar conexões para um processo local, ele deve obter um identificador de redirecionamento com a função FwpsRedirectHandleCreate0 e colocar o identificador na estrutura FWPS_CONNECT_REQUEST0. O texto explicativo modifica a estrutura no classifyFn para as camadas de redirecionamento de conexão do ALE.

Depois que um driver de texto explicativo terminar de usar um identificador de redirecionamento, ele deve chamar a função FwpsRedirectHandleDestroy0 para destruir o identificador.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8
servidor com suporte mínimo	Windows Server 2012
da Plataforma de Destino	Universal
cabeçalho	fwpsk.h (inclua Fwpsk.h)
biblioteca	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Consulte também

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

classifyFn

Compartilhar via