Função FwpsRedirectHandleCreate0 (fwpsk.h)

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

ObservaçãoFwpsRedirectHandleCreate0 é uma versão específica de FwpsRedirectHandleCreate. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas 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. Defina como zero.

redirectHandle

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

Retornar valor

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 para a qual o parâmetro redirectHandle aponta contém o identificador.
Outros códigos status	Ocorreu um erro.

Comentários

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 Associação ou Redirecionamento de 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 deverá chamar a função FwpsRedirectHandleDestroy0 para destruir o identificador.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Universal
Cabeçalho	fwpsk.h (inclua Fwpsk.h)
Biblioteca	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

Confira também

FWPS_CONNECT_REQUEST0

FwpsRedirectHandleDestroy0

classifyFn