Função FwpmEngineOpen0 (fwpmk.h)

Artigo
08/07/2023

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

Observação

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

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 Constantes de Authentication-Service 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 para a sessão aberta para o mecanismo de filtro.

Retornar valor

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 status	Ocorreu um erro.

Comentários

Um driver de texto explicativo chama a função FwpmEngineOpen0 para abrir uma sessão para o mecanismo de filtro. Um identificador para uma sessão aberta para o mecanismo de filtro é um parâmetro necessário para a maioria das funções de gerenciamento da 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 com êxito uma sessão para o 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 para fechar a sessão aberta para o mecanismo de filtro.

Requisitos

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