Share via

Função FwpmProviderContextGetById3 (fwpmu.h)

  • Artigo

Recupera um contexto de provedor.

Sintaxe

DWORD FwpmProviderContextGetById3(
  HANDLE                 engineHandle,
  UINT64                 id,
  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.

id

Tipo: _In_ UINT64

providerContext

Tipo: _Outptr_ FWPM_PROVIDER_CONTEXT3**

O objeto de contexto do provedor a ser adicionado.

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