funzione di callback PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 (netfw.h)

Articolo
02/29/2024

Tipo di puntatore a funzione del punto di ingresso nel servizio chiamato per enumerare gli indirizzi delle parole chiave dinamiche per tipo. È possibile richiedere un determinato subset di oggetti in base ai flag di enumerazione passati.

Nota

Un tipo di puntatore per questa funzione gratuita viene pubblicato tramite NetFw.h, ma non viene pubblicata una libreria di collegamenti statici. Usare il modelloGetProcAddress LoadLibraryExW/ per chiamare questa funzione.

Quando si chiama GetProcAddress, passare un handle al modulo firewallapi.dll e passare FWEnumDynamicKeywordAddressesByType0 come argomento lpProcName .

Per altre info ed esempi di codice, vedi Parole chiave dinamiche del firewall.

Sintassi

PFN_FWENUMDYNAMICKEYWORDADDRESSESBYTYPE0 PfnFwenumdynamickeywordaddressesbytype0;

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

Parametri

flags

Tipo: DWORD

L'utilizzo del valore FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_AUTO_RESOLVE enumera tutti gli oggetti con il flag FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE impostato.

L'utilizzo del valore FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE enumera tutti gli oggetti con il flag FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEnon impostato.

L'utilizzo del valore FW_DYNAMIC_KEYWORD_ADDRESS_ENUM_FLAGS_NON_AUTO_RESOLVE enumererà tutti gli oggetti.

dynamicKeywordAddressData

Tipo: _Out_ PFW_DYNAMIC_KEYWORD_ADDRESS0*

Indirizzo di un puntatore a un oggetto indirizzo di parola chiave dinamica, che conterrà un elenco collegato di oggetti restituiti. È necessario liberare questo indirizzo chiamando FWFreeDynamicKeywordAddressData0.

Valore restituito

Tipo: DWORD

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS. In caso contrario, restituisce uno dei valori seguenti.

Valore restituito	Descrizione
ERROR_INVALID_PARAMETER	Per il parametro flags è stato passato un valore zero.

Commenti

È necessario liberare l'indirizzo del primo oggetto restituito nell'elenco (l'intestazione dell'elenco) chiamando FWFreeDynamicKeywordAddressData0.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Piattaforma di destinazione	Windows
Intestazione	netfw.h
DLL	firewallapi.dll

Vedi anche

Parole chiave dinamiche del firewall

Condividi tramite