FwpsCalloutUnregisterById0-Funktion (fwpsk.h)
Die Funktion FwpsCalloutUnregisterById0 hebt die Registrierung einer Legende in der Filter-Engine auf.
Syntax
NTSTATUS FwpsCalloutUnregisterById0(
[in] const UINT32 calloutId
);
Parameter
[in] calloutId
Der Laufzeitbezeichner für die Legende, die bei der Filter-Engine nicht registriert wird. Dies muss der Laufzeitbezeichner sein, der zurückgegeben wurde, wenn der Legendentreiber entweder die Funktion FwpsCalloutRegister0 oder FwpsCalloutRegister1 aufgerufen hat, um die Legende bei der Filter-Engine zu registrieren.
Rückgabewert
Die FwpsCalloutUnregisterById0-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Legende wurde erfolgreich von der Filter-Engine registriert. |
|
Es gibt einen oder mehrere Datenflüsse, die von der Legende verarbeitet werden und über einen ausstehenden Kontext verfügen, der dem Datenfluss zugeordnet ist. Ein Legendentreiber muss die FwpsFlowRemoveContext0-Funktion für jeden dieser Datenflüsse aufrufen, um den zugeordneten Kontext zu entfernen. Nachdem der Kontext erfolgreich aus jedem dieser Datenflüsse entfernt wurde, muss der Legendentreiber die Funktion FwpsCalloutUnregisterById0 erneut aufrufen, um die Registrierung der Legende in der Filter-Engine aufzuheben. |
|
Es ist keine Legende mit der Filter-Engine registriert, die mit dem im parameter calloutId angegebenen Laufzeitbezeichner übereinstimmt. |
|
Die Legende wird bereits in einem anderen Thread registriert oder aufgehoben. |
|
Ein Fehler ist aufgetreten. |
Hinweise
Ein Legendentreiber ruft die FwpsCalloutUnregisterById0-Funktion auf, um die Registrierung einer Legende in der Filter-Engine aufzuheben, wobei der Laufzeitbezeichner verwendet wird, um die Legende zu identifizieren, die nicht registriert werden soll. Diese Funktion ist auch dann erfolgreich, wenn in der Filter-Engine Filter vorhanden sind, die die Beschriftung für die Aktion des Filters angeben. In diesem Fall werden Filter mit dem Aktionstyp FWP_ACTION_CALLOUT_TERMINATING oder FWP_ACTION_CALLOUT_UNKNOWN als FWP_ACTION_BLOCK behandelt, und Filter mit dem Aktionstyp FWP_ACTION_CALLOUT_INSPECTION werden ignoriert, nachdem die Legende von der Filter-Engine aufgehoben wurde.
Ein Legendentreiber kann erst entladen werden, wenn alle Legenden, die zuvor bei der Filter-Engine registriert wurden, erfolgreich aufgehoben wurden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows Vista. |
| Zielplattform | Universell |
| Header | fwpsk.h (include Fwpsk.h) |
| Bibliothek | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |