Função FwpmProviderContextAdd1 (fwpmk.h)
A função FwpmProviderContextAdd1 adiciona um novo contexto de provedor ao sistema.
Sintaxe
NTSTATUS FwpmProviderContextAdd1(
[in] HANDLE engineHandle,
[in] const FWPM_PROVIDER_CONTEXT1 *providerContext,
[in, optional] PSECURITY_DESCRIPTOR sd,
[out, optional] UINT64 *id
);
Parâmetros
[in] engineHandle
Manipule uma sessão aberta para o mecanismo de filtro. Chame FwpmEngineOpen0 para abrir uma sessão no mecanismo de filtro.
[in] providerContext
O objeto de contexto do provedor a ser adicionado.
[in, optional] sd
Informações de segurança associadas ao objeto de contexto do provedor.
[out, optional] id
Ponteiro para uma variável que recebe um identificador de runtime para esse contexto de provedor.
Valor de retorno
| Código/valor de retorno | Descrição |
|---|---|
|
ERROR_SUCCESS 0 |
O contexto do provedor foi adicionado com êxito. |
|
ERROR_NOT_SUPPORTED 0x32 |
O FWPM_IPSEC_IKE_MM_CONTEXTe o método de autenticação IKEEXT_IPV6_CGA na matriz authenticationMethods, mas o endereço gerado criptograficamente (CGA) não está habilitado no registro. |
|
FWP_E_* código de erro 0x80320001 — 0x80320039 |
Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte de códigos de erro do WFP para obter detalhes. |
| código de erro RPC_* 0x80010001 — 0x80010122 |
Falha ao se comunicar com o mecanismo de firewall local ou remoto. |
| outros códigos NTSTATUS | Ocorreu um erro. |
Observações
Alguns campos na estrutura FWPM_PROVIDER_CONTEXT1 são atribuídos pelo sistema, não pelo chamador e são ignorados na chamada para FwpmProviderContextAdd1.
Se o chamador fornecer um descritor de segurança NULL, o sistema atribuirá um descritor de segurança padrão.
Essa função não pode ser chamada de dentro de uma transação somente leitura, ela falha com FWP_E_INCOMPATIBLE_TXN. Consulte de Gerenciamento de Objetos para obter mais informações sobre transações.
O chamador precisa FWPM_ACTRL_ADD acesso ao contêiner do contexto do provedor e FWPM_ACTRL_ADD_LINK acesso ao provedor (se houver). Consulte de Controle de Acesso para obter mais informações.
FwpmProviderContextAdd0 é uma implementação específica de FwpmProviderContextAdd. Consulte nomes de Version-Independent WFP e versões específicas de destino do Windows para obter mais informações.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows Vista. |
| da Plataforma de Destino | Universal |
| cabeçalho | fwpmk.h |
| biblioteca | fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |