Função FwpsvSwitchEventsSubscribe0 (fwpsk.h)

  • Artigo

A função FwpsvSwitchEventsSubscribe0 registra pontos de entrada de retorno de chamada para eventos de camada de comutador virtual, como criação e exclusão de porta virtual.

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

 

Sintaxe

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

Parâmetros

providerGuid

O GUID do provedor.

notifyContext

Um ponteiro opcional para um contexto fornecido pelo driver de texto explicativo. As funções de notificação de evento passam esse parâmetro de volta para o driver.

flags

Reservado. Defina como zero.

reserved

Reservado. Defina como zero.

eventDispatchTable

Um ponteiro para uma estrutura FWPS_VSWITCH_EVENT_DISPATCH_TABLE que define os pontos de entrada de retorno de chamada para eventos de camada de comutador virtual.

subscriptionId

Um ponteiro para uma variável que contém um identificador exclusivo que o WFP atribui à assinatura. O chamador deve retornar o identificador de assinatura ao WFP com a função FwpsvSwitchEventsUnsubscribe0 .

Retornar valor

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

Código de retorno Descrição
STATUS_SUCCESS
 Um identificador para a solicitação de classificação foi retornado com êxito. A variável para a qual o parâmetro classifyHandle aponta contém o identificador da solicitação de classificação.
Outros códigos status
 Ocorreu um erro.

Comentários

Um driver de texto explicativo chama a função FwpsvSwitchEventsSubscribe0 para registrar pontos de entrada de retorno de chamada para eventos de camada de comutador virtual.

Os pontos de entrada para as funções de notificação de retorno de chamada são especificados em e FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 estrutura.

O driver de texto explicativo deve chamar posteriormente FwpsvSwitchEventsUnsubscribe0 para liberar os recursos do sistema.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows 8.
Plataforma de Destino Universal
Cabeçalho fwpsk.h (inclua Fwpsk.h)
Biblioteca Fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Confira também

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0