Freigeben über

PFN_FWADDDYNAMICKEYWORDADDRESS0 Rückruffunktion (netfw.h)

  • Artikel

Funktionszeigertyp des Einstiegspunkts im Dienst, den Sie aufrufen, um die angegebene dynamische Schlüsselwort (keyword) Adresse hinzuzufügen.

Hinweis

Ein Zeigertyp für diese kostenlose Funktion wird über NetFw.hveröffentlicht, aber eine Static-Link-Bibliothek wird nicht veröffentlicht. Verwenden Sie das LoadLibraryExW/GetProcAddress-Muster , um diese Funktion aufzurufen.

Wenn Sie GetProcAddress aufrufen, übergeben Sie ein Handle an das modulfirewallapi.dll , und übergeben Sie FWAddDynamicKeywordAddress0 als argument lpProcName .

Weitere Informationen und Codebeispiele finden Sie unter Dynamische Schlüsselwörter für Firewalls.

Syntax

PFN_FWADDDYNAMICKEYWORDADDRESS0 PfnFwadddynamickeywordaddress0;

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

Parameter

dynamicKeywordAddress

Typ: const PFW_DYNAMIC_KEYWORD_ADDRESS0

Ein Zeiger auf ein konstantes dynamisches Schlüsselwort (keyword)-Adressobjekt.

Rückgabewert

Typ: DWORD

Wenn die Funktion erfolgreich ist (das Objekt wurde erfolgreich erstellt und hinzugefügt), wird ERROR_SUCCESS zurückgegeben. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabewert BESCHREIBUNG
ERROR_ACCESS_DENIED Der Aufrufer verfügt nicht über die richtigen Berechtigungen zum Erstellen dieses Objekts.
ERROR_ALREADY_EXISTS Ein Objekt mit der angegebenen ID ist bereits im System vorhanden.
ERROR_INVALID_PARAMETER Ungültige FW_DYNAMIC_KEYWORD_ADDRESS0. Weitere Informationen finden Sie unter Hinweise zur gültigen Verwendung.

Hinweise

  • Wenn das FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE-Flag festgelegt ist, gehen Sie wie folgt vor:
    • die Adressen müssen NULL sein, und
    • Das feld Schlüsselwort (keyword) sollte eine Zeichenfolge sein, die aufgelöst werden kann, d. h. ein FQDN oder Hostname.
  • Wenn das flag FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEnicht festgelegt ist, muss das Adressfeld eine durch Trennzeichen getrennte Liste von IP-Adresstoken sein. Token können einzelne IP-Adressen, Bereiche oder Subnetze sein. Gültige Tokenformate sind:
    • Eine gültige IPv4-Adresse (z. B. 10.0.0.10)
    • Eine gültige IPv6-Adresse (z. B. 2620:1ec:c11::200)
    • Ein IPv4-Adressbereich im Format <Startadresse-End-Adresse><> ohne Leerzeichen (z. B. 10.0.0.0-10.0.0.255)
    • Ein IPv6-Adressbereich im Format <start address-end> address-end address>,< with no spaces included (z. B. 2001:db8:abcd:12::-2001:db8:abcd:12:ffff:ffff:ffff:ffff:ffff)
    • Ein gültiges IPv4-Subnetz, das mithilfe der Netzwerkpräfixnotation angegeben wird (z. B. 10.0.0.0/24).
    • Ein gültiges IPv6-Subnetz, das mithilfe der Präfixlängennotation angegeben wird (z. B. 2001:db8:abcd:0012::0/64).
  • Eine dynamische Schlüsselwort (keyword)-Adresse wird über Neustarts hinweg beibehalten. Für die AutoResolved-Objekte werden die Adressen nicht über Startzyklen hinweg beibehalten und müssen während des folgenden Startzyklus neu ausgewertet werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Zielplattform Windows
Kopfzeile netfw.h
DLL firewallapi.dll

Weitere Informationen