PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 funzione di callback (netfw.h)

Articolo
03/05/2024

Tipo di puntatore a funzione del punto di ingresso nel servizio chiamato per aggiornare l'indirizzo della parola chiave dinamica con l'ID di input.

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 FWFreeDynamicKeywordAddressData0 come argomento lpProcName .

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

Sintassi

PFN_FWUPDATEDYNAMICKEYWORDADDRESS0 PfnFwupdatedynamickeywordaddress0;

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

Parametri

dynamicKeywordAddressId

Tipo: GUID

ID dell'oggetto indirizzo della parola chiave dinamica da aggiornare.

updatedAddresses

Tipo: PCWSTR

Elenco delimitato da virgole di indirizzi IP, subnet o intervalli con cui aggiornare l'oggetto.

append

Tipo: BOOL

Impostare su TRUE e gli oggetti updatedAddresses verranno aggiunti all'elenco corrente di indirizzi dell'oggetto. Impostare su FALSE e updatedAddresses sostituirà l'elenco corrente di indirizzi dell'oggetto.

Valore restituito

Tipo: DWORD

Se la funzione ha esito positivo (l'oggetto è stato aggiornato 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 operare sull'oggetto con l'ID specificato. Questo errore si verifica quando questa API viene chiamata su oggetti non AutoResolve gestiti da MDM.
ERROR_INVALID_PARAMETER	Le condizioni di errore comuni includono: nessun oggetto con l'ID specificato esiste; gli indirizzi sono in formato non valido.

Commenti

Se append è TRUE, gli indirizzi di input verranno aggiunti all'elenco corrente di indirizzi dell'oggetto. Se il parametro di input è un duplicato di un indirizzo già impostato nell'oggetto, verrà rimosso e ERROR_SUCCESS verrà restituito.

Il servizio firewall considera un indirizzo come duplicato se l'indirizzo è esattamente equivalente a un valore nel campo indirizzi esistenti dell'indirizzo della parola chiave dinamica. I valori duplicati vengono considerati in base a un singolo elemento, pertanto un aggiornamento con un elenco di indirizzi IP potrebbe avere solo un subset di input duplicato ignorato. Ad esempio, se l'oggetto indirizzo della parola chiave dinamica contiene 127.0.0.0-127.0.0.255, qualsiasi input di 127.0.0.0-127.0.0.255 o 127.0.0.0/24 verrebbe rimosso. Tuttavia, un input come 127.0.0.0-127.0.0.40 non verrebbe rimosso, poiché si tratta di un subset e non di un duplicato diretto.

Se append è FALSE, l'elenco corrente di indirizzi dell'oggetto verrà sovrascritto dall'input.

Gli oggetti non AutoResolve originati da MDM genereranno ERROR_ACCESS_DENIED.

Gli oggetti non AutoResolve creati in locale (tramite API o PowerShell) vengono aggiornati tramite questa API.

Gli oggetti AutoResolve di qualsiasi origine sono aggiornabili tramite questa API.

Per cancellare gli indirizzi per un oggetto, passare NULL per il valore updatedAddresses .

Il formato valido per il parametro updatedAddresses è 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 nel formato <indirizzo-fine< dell'indirizzo>> iniziale, senza spazi inclusi (ad esempio, 10.0.0.0-10.0.0.255)
Intervallo di indirizzi IPv6 nel formato <indirizzo-fine< dell'indirizzo>> iniziale, senza spazi inclusi (ad esempio, 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff)
Subnet IPv4 valida specificata usando la notazione del prefisso di rete,ad esempio 10.0.0.0/24
Subnet IPv6 valida specificata usando la notazione di lunghezza del prefisso (ad esempio, 2001:db8:abcd:0012::0/64)

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