Função FwpmProviderContextGetByKey3 (fwpmu.h)
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 a mesma GUID que foi especificada quando seu aplicativo chamou FwpmProviderContextAdd3 para esse objeto.
providerContext
Tipo: _Outptr_ FWPM_PROVIDER_CONTEXT3**
As informações de contexto do provedor.
Valor de retorno
Código/valor de retorno | 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 local ou remoto. |
Observações
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 de controle de acesso.
Requisitos
Requisito | Valor |
---|---|
cabeçalho | fwpmu.h |
biblioteca | Fwpuclnt.lib |
de DLL | Fwpuclnt.dll |