Freigeben über

FwpmDynamicKeywordSubscribe0-Funktion (fwpmu.h)

  • Artikel

Fordert die Zustellung von Benachrichtigungen zu Änderungen an bestimmten dynamischen Schlüsselwort (keyword)-Adressobjekten (FW_DYNAMIC_KEYWORD_ADDRESS0) an. Basierend auf dem übergebenen Flag können Benachrichtigungen nur für eine Teilmenge der Adressen ausgelöst werden.

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

Syntax

DWORD FwpmDynamicKeywordSubscribe0(
  DWORD                          flags,
  FWPM_DYNAMIC_KEYWORD_CALLBACK0 callback,
  void                           *context,
  HANDLE                         *subscriptionHandle
);

Parameter

flags

Typ: _In_ DWORD

Die folgenden Flags sind in fwpmu.hdefiniert.

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE gibt an, dass Benachrichtigungen nur für Objekte übermittelt werden, für die das flag FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVE festgelegt ist.

FWPM_NOTIFY_ADDRESSES_NON_AUTO_RESOLVE gibt an, dass Benachrichtigungen nur für Objekte übermittelt werden, für die das flag FW_DYNAMIC_KEYWORD_ADDRESS_FLAGS_AUTO_RESOLVEnicht festgelegt ist.

FWPM_NOTIFY_ADDRESSES_AUTO_RESOLVE gibt an, dass Benachrichtigungen für alle dynamischen Schlüsselwort (keyword) Adressobjekte übermittelt werden.

callback

Typ: _In_ FWPM_DYNAMIC_KEYWORD_CALLBACK0

Ein Zeiger auf eine Rückruffunktion, die Sie implementieren, die aufgerufen wird, wenn eine Benachrichtigung zur Übermittlung bereit ist.

context

Typ: _In_opt_ void*

: Ein optionaler Kontextzeiger. Dieser Zeiger wird an die Rückruffunktion übergeben.

subscriptionHandle

Typ: _Out_ HANDLE*

Die Adresse eines Handles, das mit einem Handle für das neu erstellte Abonnement aufgefüllt wird.

Rückgabewert

Typ: DWORD

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben. Andernfalls wird einer der folgenden Werte zurückgegeben.

Rückgabewert BESCHREIBUNG
ERROR_INVALID_PARAMETER Der Flagwert ist 0 (null).

Hinweise

Benachrichtigungen für dynamische AutoResolve-Schlüsselwort (keyword)-Adressen werden übermittelt, wenn ein Objekt hinzugefügt oder gelöscht wird.

Benachrichtigungen für dynamische Schlüsselwort (keyword) Adressen, die keine AutoResolve sind, werden übermittelt, wenn ein Objekt hinzugefügt, gelöscht oder aktualisiert wird.

Für die Rückruffunktion werden keine Daten bereitgestellt. Sie können die Enumerations-API verwenden, wenn Sie Informationen dazu benötigen, was sich am System geändert hat.

Sie sind dafür verantwortlich, das Handle zu schließen, wenn Sie kein Abonnement mehr benötigen. Dazu müssen Sie die Funktion FwpmDynamicKeywordUnsubscribe0 aufrufen.

Ihre Implementierung von FWPM_DYNAMIC_KEYWORD_CALLBACK0 sollte schnell auf Änderungen in dynamischen Schlüsselwort (keyword) Adressobjekten reagieren, da sie in einem ThreadPool-Thread geplant ist und sich auf andere Wartevorgänge auswirken kann.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Zielplattform Windows
Kopfzeile fwpmu.h
Bibliothek Fwpuclnt.lib
DLL Fwpuclnt.dll

Weitere Informationen