Condividi tramite

PFN_FWADDDYNAMICKEYWORDADDRESS0 funzione di callback (netfw.h)

  • Articolo

Tipo di puntatore di funzione del punto di ingresso nel servizio chiamato per aggiungere l'indirizzo della parola chiave dinamica specificata.

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 modello LoadLibraryExW/GetProcAddress per chiamare questa funzione.

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

Per altre informazioni ed esempi di codice, vedere Parole chiave dinamiche del firewall.

Sintassi

PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;

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

Parametri

dynamicKeywordAddress

Tipo: const PFW_DYNAMIC_KEYWORD_ADDRESS0

Puntatore a un oggetto indirizzo di parola chiave dinamico (popolato).

Valore restituito

Tipo: DWORD

Se la funzione ha esito positivo (l'oggetto è stato creato e aggiunto correttamente), restituisce ERROR_SUCCESS. In caso contrario, restituisce uno dei valori seguenti.

Valore restituito Descrizione
ERROR_ACCESS_DENIED Il chiamante non dispone delle autorizzazioni appropriate per creare questo oggetto.
ERROR_ALREADY_EXISTS Un oggetto con l'ID specificato esiste già nel sistema.
ERROR_INVALID_PARAMETER FW_DYNAMIC_KEYWORD_ADDRESS0 non valido. Vedere Osservazioni per l'utilizzo valido.

Commenti

  • Se il flag di FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE è impostato, quindi:
    • gli indirizzi devono essere NULL e
    • il campo della parola chiave deve essere una stringa che può essere risolta; ovvero un nome di dominio completo o host.
  • Se il flag di FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEnon è impostato, il campo indirizzi deve essere un elenco delimitato da virgole di token di indirizzo IP. I token possono essere singoli indirizzi IP, intervalli o subnet. I formati di token validi includono:
    • Indirizzo IPv4 valido,ad esempio 10.0.0.10)
    • Indirizzo IPv6 valido,ad esempio 2620:1ec:c11::200)
    • Intervallo di indirizzi IPv4 nell'indirizzo><> iniziale del formato<, senza spazi inclusi,ad esempio 10.0.0.0-10.0.0.0.0.255)
    • Intervallo di indirizzi IPv6 nell'indirizzo><> iniziale del formato<, senza spazi inclusi, ad esempio 2001:db8:abcd:12::-2001:db8:abcd:12:ffffff)
    • Una subnet IPv4 valida specificata usando la notazione del prefisso di rete ,ad esempio 10.0.0.0.0/24)
    • Una subnet IPv6 valida specificata usando la notazione della lunghezza del prefisso , ad esempio 2001:db8:abcd:0012::0/64)
  • Un indirizzo di parola chiave dinamico persiste tra i riavvii. Per gli oggetti AutoResolved , gli indirizzi non vengono mantenuti nei cicli di avvio e devono essere rivalutati durante il ciclo di avvio seguente.

Requisiti

   
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