Compartilhar via

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

  • Artigo

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

Observação

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

Ao chamar GetProcAddress, passe um identificador para o módulo firewallapi.dll e passe FWFreeDynamicKeywordAddressData0 como o argumento lpProcName .

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

Sintaxe

PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 PfnFwupdatedynamickeywordaddress0;

DWORD PfnFwupdatedynamickeywordaddress0(
  GUID dynamicKeywordAddressId,
  PCWSTR updatedAddresses,
  BOOL append
)
{...}

Parâmetros

dynamicKeywordAddressId

Tipo: GUID

A ID do objeto de endereço de palavra-chave dinâmico a ser atualizado.

updatedAddresses

Tipo: PCWSTR

Uma lista separada por vírgulas de endereços IP, sub-redes ou intervalos com os quais atualizar o objeto.

append

Tipo: BOOL

Defina como TRUE e updatedAddresses será acrescentado à lista atual de endereços do objeto. Defina como FALSE e updatedAddresses substituirá a lista atual de endereços do objeto.

Retornar valor

Tipo: DWORD

Se a função for bem-sucedida (o objeto foi atualizado com êxito), ele 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 operar no objeto com a ID especificada. Esse erro ocorre quando essa API é chamada em objetos não AutoResolve gerenciados pelo MDM.
ERROR_INVALID_PARAMETER As condições de erro comuns incluem: nenhum objeto com a ID especificada existe; os endereços estão em um formato inválido.

Comentários

Se acréscimo for TRUE, os endereços de entrada serão acrescentados à lista atual de endereços do objeto. Se o parâmetro de entrada for uma duplicata de um endereço já definido no objeto , ele será descartado e ERROR_SUCCESS será retornado.

O serviço de firewall tratará um endereço como duplicado se o endereço for exatamente equivalente a um valor no campo endereços existentes do endereço de palavra-chave dinâmico. Os valores duplicados são considerados em uma base de elemento individual, portanto, uma atualização com uma lista de endereços IP pode ter apenas um subconjunto de entrada duplicada descartado. Por exemplo, se o objeto de endereço de palavra-chave dinâmico contiver 127.0.0.0-127.0.0.255, qualquer entrada de 127.0.0.0-127.0.0.255 ou 127.0.0.0/24 será descartada. No entanto, uma entrada como 127.0.0.0-127.0.0.40 não seria descartada, pois é um subconjunto e não uma duplicata direta.

Se append for FALSE, a lista atual de endereços do objeto será substituída pela entrada.

Objetos não AutoResolve originados do MDM resultarão em ERROR_ACCESS_DENIED.

Objetos não AutoResolve que foram criados localmente (por meio da API ou do PowerShell) são atualizados por meio dessa API.

Objetos AutoResolve de qualquer origem podem ser atualizados por meio dessa API.

Para limpar os endereços de um objeto, passe NULL para o valor updatedAddresses .

O formato válido para o parâmetro updatedAddresses é 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 extremidade de< endereço> inicial, sem espaços incluídos (por exemplo, 10.0.0.0-10.0.0.255)
  • Um intervalo de endereços IPv6 no formato <endereço> de extremidade de< endereço> inicial, 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)

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 netfw.h
DLL firewallapi.dll

Confira também