Compartilhar via

PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 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 enumerar endereços dinâmicos palavra-chave por tipo. Você pode solicitar um subconjunto específico de objetos com base nos sinalizadores de enumeração passados.

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 FWEnumDynamicKeywordAddressesByType0 como o argumento lpProcName .

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

Sintaxe

PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 PfnFwenumdynamickeywordaddressesbytype0;

DWORD PfnFwenumdynamickeywordaddressesbytype0(
  DWORD flags,
  PFW_DYNAMIC_KEYWORD_ADDRESS_DATA0 *dynamicKeywordAddressData
)
{...}

Parâmetros

flags

Tipo: DWORD

O uso do valor FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_AUTO_RESOLVE enumerará todos os objetos que têm o sinalizador FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE definido.

Usar o valor FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE enumerará todos os objetos que têm o sinalizador FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEnão definido.

Usar o valor FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE enumerará todos os objetos.

dynamicKeywordAddressData

Tipo: _Out_ PFW_DYNAMIC_KEYWORD_ADDRESS0*

O endereço de um ponteiro para um objeto de endereço de palavra-chave dinâmico, que conterá uma lista vinculada de objetos retornados. Você deve liberar esse endereço chamando FWFreeDynamicKeywordAddressData0.

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 Um valor zero foi passado para o parâmetro flags .

Comentários

Você deve liberar o endereço do primeiro objeto retornado na lista (o cabeçalho da lista) chamando FWFreeDynamicKeywordAddressData0.

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