Função FwpmProviderContextGetById3 (fwpmu.h)

Recupera um contexto de provedor.

Sintaxe

DWORD FwpmProviderContextGetById3(
  HANDLE                 engineHandle,
  UINT64                 id,
  FWPM_PROVIDER_CONTEXT3 **providerContext
);

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

O objeto de contexto do provedor a ser adicionado.

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.

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.