Função FwpmDynamicKeywordSubscribe0 (fwpmu.h)
Solicita a entrega de notificações sobre alterações em objetos de endereço de palavra-chave dinâmicos específicos (FW_DYNAMIC_KEYWORD_ADDRESS0). Com base no sinalizador passado, as notificações podem ser geradas apenas para um subconjunto dos endereços.
Para obter mais informações e exemplos de código, consulte Palavras-chave dinâmicas do firewall.
Sintaxe
DWORD FwpmDynamicKeywordSubscribe0(
DWORD flags,
FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
void *context,
HANDLE *subscriptionHandle
);
Parâmetros
flags
Tipo: _In_ DWORD
Os sinalizadores a seguir são definidos em fwpmu.h.
FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE indica que as notificações serão entregues somente para objetos que têm o sinalizador FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE definido.
FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVE indica que as notificações serão entregues somente para objetos que não têm o sinalizador FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE definido.
FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE indica que as notificações serão entregues para todos os objetos de endereço de palavra-chave dinâmicos.
callback
Tipo: _In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0
Um ponteiro para uma função de retorno de chamada implementada, que será invocada quando uma notificação estiver pronta para entrega.
context
Tipo: _In_opt_ void*
Um ponteiro de contexto opcional. Esse ponteiro é passado para a função de retorno de chamada.
subscriptionHandle
Tipo: _Out_ HANDLE*
O endereço de um identificador, que é preenchido com um identificador para a assinatura recém-criada.
Retornar valor
Tipo: DWORD
Se a função for bem-sucedida, ela retornará ERROR_SUCCESS. Caso contrário, ele retornará um dos valores a seguir.
| Valor retornado | Descrição |
|---|---|
| ERROR_INVALID_PARAMETER | O valor de sinalizadores é zero. |
Comentários
As notificações para endereços de palavra-chave dinâmicos do AutoResolve são entregues quando um objeto é adicionado ou excluído.
As notificações para endereços de palavra-chave dinâmicos não AutoResolve são entregues quando um objeto é adicionado, excluído ou atualizado.
Nenhum dado é fornecido para a função de retorno de chamada. Você pode usar a API de Enumeração se precisar de informações sobre o que foi alterado no sistema.
Você é responsável por fechar o identificador quando não precisa mais de assinatura. Você deve fazer isso chamando a função FwpmDynamicKeywordUnsubscribe0 .
Sua implementação de FWPM_DYNAMIC_KEYWORD_CALLBACK0 deve reagir a alterações em objetos de endereço de palavra-chave dinâmicos rapidamente, pois ele está agendado em um thread do ThreadPool e pode afetar outras operações de espera.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10 Build 20348 |
| Servidor mínimo com suporte | Windows 10 Build 20348 |
| Plataforma de Destino | Windows |
| Cabeçalho | fwpmu.h |
| Biblioteca | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |