Compartilhar via

Função FwpmEngineOpen0 (fwpmk.h)

  • Artigo

A função FwpmEngineOpen0 abre uma sessão para o mecanismo de filtro.

Sintaxe

NTSTATUS FwpmEngineOpen0(
  [in, optional] const wchar_t             *serverName,
  [in]           UINT32                    authnService,
  [in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
  [in, optional] const FWPM_SESSION0       *session,
  [out]          HANDLE                    *engineHandle
);

Parâmetros

[in, optional] serverName

Um ponteiro para uma cadeia de caracteres terminada em NULL que especifica o nome DNS padrão do sistema no qual a sessão para o mecanismo de filtro é aberta. Os drivers de texto explicativo devem especificar NULL para esse parâmetro.

[in] authnService

O serviço de autenticação a ser usado. Para obter uma lista de opções válidas para esse parâmetro, consulte Authentication-Service Constantes na seção RPC na documentação do SDK do Microsoft Windows. Os drivers de texto explicativo devem especificar RPC_C_AUTHN_WINNT ou RPC_C_AUTHN_DEFAULT para esse parâmetro.

[in, optional] authIdentity

Um ponteiro para uma estrutura SEC_WINNT_AUTH_IDENTITY_W que contém as credenciais de autenticação e autorização para acessar o mecanismo de filtro. Esse parâmetro é ignorado quando a função FwpmEngineOpen0 é chamada de um driver de texto explicativo. Os drivers de texto explicativo devem definir esse parâmetro como NULL.

[in, optional] session

Um ponteiro para uma estrutura FWPM_SESSION0 que define parâmetros específicos da sessão para a sessão que está sendo aberta. Esse ponteiro é opcional e pode ser NULL.

[out] engineHandle

Um ponteiro para uma variável que recebe um identificador da sessão aberta para o mecanismo de filtro.

Valor de retorno

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

Código de retorno Descrição
STATUS_SUCCESS Uma sessão para o mecanismo de filtro foi aberta com êxito. A variável apontada pelo parâmetro engineHandle contém um identificador para a sessão aberta.
outros códigos NTSTATUS Ocorreu um erro.

Observações

Um driver explicativo chama a função FwpmEngineOpen0 para abrir uma sessão no mecanismo de filtro. Um identificador de uma sessão aberta para o mecanismo de filtro é um parâmetro necessário para a maioria das funções de gerenciamento Plataforma de Filtragem do Windows.

Normalmente, os drivers de texto explicativo não precisam abrir uma sessão para o mecanismo de filtro porque os drivers de texto explicativo normalmente não chamam nenhuma das funções de gerenciamento da Plataforma de Filtragem do Windows .

Para que um driver de texto explicativo abra uma sessão com êxito no mecanismo de filtro, o mecanismo de filtro deve estar em execução no momento em que o driver de texto explicativo chama a função FwpmEngineOpen0. Um driver de texto explicativo pode chamar a função FwpmBfeStateGet0 para obter o estado atual do mecanismo de filtro. Antes de chamar FwpmBfeStateGet0, o driver de texto explicativo deve chamar a função FwpmBfeStateSubscribeChanges0 para registrar uma função de retorno de chamada que será chamada sempre que houver uma alteração no estado do mecanismo de filtro.

Depois que um driver de texto explicativo terminar de acessar o mecanismo de filtro, ele chamará a função FwpmEngineClose0 do para fechar a sessão aberta para o mecanismo de filtro.

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows Vista.
da Plataforma de Destino Universal
cabeçalho fwpmk.h (inclua Fwpmk.h)
biblioteca Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Consulte também