Compartilhar via

Função FwpmProviderContextGetByKey3 (fwpmu.h)

  • Artigo

Recupera um contexto de provedor.

Sintaxe

DWORD FwpmProviderContextGetByKey3(
  HANDLE                 engineHandle,
  const GUID             *key,
  FWPM_PROVIDER_CONTEXT3 **providerContext
);

Parâmetros

engineHandle

Tipo: _In_ HANDLE

Um identificador para uma sessão aberta com o mecanismo de filtro. Para abrir uma sessão com o mecanismo de filtro, chame FwpmEngineOpen0.

key

Tipo: _In_ const GUID*

Ponteiro para um GUID que identifica exclusivamente o contexto do provedor. Esse é um ponteiro para o mesmo GUID que foi especificado quando seu aplicativo chamou FwpmProviderContextAdd3 para esse objeto.

providerContext

Tipo: _Outptr_ FWPM_PROVIDER_CONTEXT3**

As informações de contexto do provedor.

Retornar valor

Tipo: DWORD*

Valor/código retornado Descrição
ERROR_SUCCESS
0		 O contexto do provedor foi recuperado com êxito.
código de erro FWP_E_*
0x80320001 — 0x80320039		 Um erro específico da Plataforma de Filtragem do Windows (WFP). Para obter detalhes, consulte Códigos de erro do WFP.
código de erro RPC_*
0x80010001 — 0x80010122		 Falha ao se comunicar com o mecanismo de firewall remoto ou local.

Comentários

Você deve liberar o objeto retornado chamando FwpmFreeMemory0.

Para chamar essa função, você precisa FWPM_ACTRL_READ acesso ao contexto do provedor. Para obter mais informações, consulte Controle de acesso.

Requisitos

Requisito Valor
Cabeçalho fwpmu.h
Biblioteca Fwpuclnt.lib
DLL Fwpuclnt.dll