Função FwpmProviderSubscribeChanges0 (fwpmu.h)
A função FwpmProviderSubscribeChanges0 é usada para solicitar a entrega de notificações sobre alterações em um provedor específico.
Sintaxe
DWORD FwpmProviderSubscribeChanges0(
[in] HANDLE engineHandle,
[in, optional] const FWPM_PROVIDER_SUBSCRIPTION0 *subscription,
[in] FWPM_PROVIDER_CHANGE_CALLBACK0 callback,
[in, optional] void *context,
[out] HANDLE *changeHandle
);
Parâmetros
[in] engineHandle
Tipo: HANDLE
Identificador de uma sessão aberta para o mecanismo de filtro. Chame FwpmEngineOpen0 para abrir uma sessão para o mecanismo de filtro.
[in, optional] subscription
Tipo: FWPM_PROVIDER_SUBSCRIPTION0*
As notificações a serem entregues.
[in] callback
Tipo: FWPM_PROVIDER_CHANGE_CALLBACK0
Ponteiro de função que será invocado quando uma notificação estiver pronta para entrega.
[in, optional] context
Tipo: void*
Ponteiro de contexto opcional. Esse ponteiro é passado para a função de retorno de chamada junto com os detalhes da alteração.
[out] changeHandle
Tipo: HANDLE*
Manipule para a assinatura recém-criada.
Retornar valor
Tipo: DWORD
| Valor/código retornado | Descrição |
|---|---|
|
A assinatura foi criada com êxito. |
|
Um erro específico da Plataforma de Filtragem do Windows (WFP). Consulte Códigos de erro do WFP para obter detalhes. |
|
Falha ao se comunicar com o mecanismo de firewall remoto ou local. |
Comentários
Os assinantes não recebem notificações de alterações feitas com o mesmo identificador de sessão usado para assinar. Isso ocorre porque os assinantes só precisam ver as alterações feitas por outras pessoas, pois já sabem quais alterações elas próprias fizeram.
Essa função não pode ser chamada de dentro de uma transação. Ele falhará com FWP_E_TXN_IN_PROGRESS. Consulte Gerenciamento de Objetos para obter mais informações sobre transações.
O chamador precisa FWPM_ACTRL_SUBSCRIBE acesso ao contêiner do provedor e FWPM_ACTRL_READ acesso ao provedor. O assinante só receberá notificações para provedores aos quais tem acesso FWPM_ACTRL_READ . Consulte Controle de Acesso para obter mais informações.
FwpmProviderSubscribeChanges0 é uma implementação específica de FwpmProviderSubscribeChanges. Consulte Nomes de Version-Independent WFP e Direcionamento de versões específicas do Windows para obter mais informações.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | fwpmu.h |
| Biblioteca | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |