Compartilhar via

função de retorno de chamada PFN_FWADDDYNAMICKEYWORDADDRESS0 (netfw.h)

  • Artigo

Tipo de ponteiro de função do ponto de entrada no serviço que você chama para adicionar o endereço de palavra-chave dinâmico especificado.

Observação

Um tipo de ponteiro para essa função gratuita é publicado por meio NetFw.hde , mas uma biblioteca de link estático não é publicada. Use o padrãoGetProcAddressde LoadLibraryExW/ para chamar essa função.

Quando você chamar GetProcAddress, passe um identificador para o módulo firewallapi.dll e passe FWAddDynamicKeywordAddress0 como o argumento lpProcName .

Para obter mais informações e exemplos de código, consulte Palavras-chave dinâmicas do firewall.

Sintaxe

PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;

DWORD PfnFwadddynamickeywordaddress0(
  const PFW_DYNAMIC_KEYWORD_ADDRESS0 dynamicKeywordAddress
)
{...}

Parâmetros

dynamicKeywordAddress

Tipo: const PFW_DYNAMIC_KEYWORD_ADDRESS0

Um ponteiro para um objeto de endereço de palavra-chave dinâmico constante (preenchido).

Valor retornado

Tipo: DWORD

Se a função for bem-sucedida (o objeto foi criado e adicionado com êxito), ela retornará ERROR_SUCCESS. Caso contrário, ele retornará um dos valores a seguir.

Valor retornado Descrição
ERROR_ACCESS_DENIED O chamador não tem permissões adequadas para criar esse objeto.
ERROR_ALREADY_EXISTS Um objeto com a ID especificada já existe no sistema.
ERROR_INVALID_PARAMETER FW_DYNAMIC_KEYWORD_ADDRESS0 inválida. Consulte Comentários para uso válido.

Comentários

  • Se o sinalizador FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE estiver definido, então:
    • os endereços devem ser NULL e
    • o campo palavra-chave deve ser uma cadeia de caracteres que pode ser resolvida; ou seja, um FQDN ou nome do host.
  • Se o sinalizador FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEnão estiver definido, o campo endereços deverá ser uma lista separada por vírgulas de tokens de endereço IP. Os tokens podem ser endereços IP individuais, intervalos ou sub-redes. Os formatos de token válidos incluem:
    • Um endereço IPv4 válido (por exemplo, 10.0.0.10)
    • Um endereço IPv6 válido (por exemplo, 2620:1ec:c11::200)
    • Um intervalo de endereços IPv4 no formato <>endereço> de endereço inicial<, sem espaços incluídos (por exemplo, 10.0.0.0-10.0.0.0.255)
    • Um intervalo de endereços IPv6 no endereço> de< início de formato<>, sem espaços incluídos (por exemplo, 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff:ffff)
    • Uma sub-rede IPv4 válida especificada usando a notação de prefixo de rede (por exemplo, 10.0.0.0/24)
    • Uma sub-rede IPv6 válida especificada usando a notação de comprimento do prefixo (por exemplo, 2001:db8:abcd:0012::0/64)
  • Um endereço de palavra-chave dinâmico persiste entre reinicializações. Para os objetos AutoResolved , os endereços não são persistidos entre os ciclos de inicialização e devem ser reavaliados durante o ciclo de inicialização a seguir.

Requisitos

   
Cliente mínimo com suporte Windows 10 Build 20348
Servidor mínimo com suporte Windows 10 Build 20348
Plataforma de Destino Windows
Cabeçalho netfw.h
DLL firewallapi.dll

Confira também