FWPS_BIND_REQUEST0-Struktur (fwpsk.h)

Artikel
02/26/2024

Die FWPS_BIND_REQUEST0-Struktur definiert änderbare Daten für die ebenen FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4 und FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6. Der Legendentreiber verwendet diese Daten, um die Verbindungsinformationen zu überprüfen oder zu ändern.

Beachten SieFWPS_BIND_REQUEST0 eine bestimmte Version von FWPS_BIND_REQUEST ist. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und Spezifische Windows-Versionen .

Syntax

typedef struct _FWPS_BIND_REQUEST0 {
  SOCKADDR_STORAGE           localAddressAndPort;
  UINT64                     portReservationToken;
  struct _FWPS_BIND_REQUEST0 *previousVersion;
  UINT64                     modifierFilterId;
} FWPS_BIND_REQUEST0;

Member

localAddressAndPort

Die lokale Transportadresse der Bindungsanforderung. Dies ist eine IPV4- oder IPV6-Adresse und ein TCP/UDP-Port, der als SOCKADDR_STORAGE-Struktur formatiert ist.

portReservationToken

Ein Token, das verwendet wird, um den entsprechenden Port zu reservieren. Das Token wird abgerufen, wenn ein Port reserviert ist, indem entweder CreatePersistentTcpPortReservation oder CreatePersistentUdpPortReservation aufgerufen wird. Beide Reservierungsfunktionen finden Sie in iphlpapi.h.

previousVersion

Die vorherige Version der Bindungsanforderungsdaten. Dieses schreibgeschützte Feld zeichnet den Änderungsverlauf der Bindungsanforderung auf. Dieser Member wird mit einem Zeiger auf eine singly verknüpfte Liste vorab initialisiert, wobei der Index auf den Datensatz für die aktuellen FWPS_BIND_REQUEST0 Daten festgelegt ist.

modifierFilterId

Der Wert des FilterId-Elements des Filterparameters der KlassifizierungFn-Funktion. Weitere Informationen zum FilterId-Element finden Sie unter FWPS_FILTER1.

Hinweise

Der Legendentreiber ruft diese Struktur durch Aufrufen der FwpsAcquireWritableLayerDataPointer0-Funktion , die einen Zeiger auf eine FWPS_BIND_REQUEST0-Struktur über den writableLayerData-Parameter zurückgibt.

Die klassifizierungFn-Funktion kann die Parameter der Bindungsanforderung ändern, z. B. die lokale Transportadresse oder den Port an eine andere Adresse oder einen anderen Port umleiten. Wenn die Parameter der Bindungsanforderung geändert werden,
Die klassifizierenFn-Funktion muss die folgenden Aktionen ausführen:

Nehmen Sie alle Änderungen an der FWPS_BIND_REQUEST0-Struktur vor, die von FwpsAcquireWritableLayerDataPointer0 zurückgegeben wurde. Nur die Member localAddressAndPort und portReservationToken können geändert werden.
Aufruf FwpsApplyModifiedLayerData0 mit dem modifiedLayerData-Parameter , der auf die Adresse der FWPS_BIND_REQUEST0-Struktur festgelegt ist, auch wenn der Legendentreiber keine Daten geändert hat. Dieser Wert muss mit dem Parameterwert modifiedLayerData identisch sein, der von zurückgegeben wurde. FwpsAcquireWritableLayerDataPointer0.

Diese Struktur fungiert als verknüpfte Liste, die einen Datensatz aller Änderungen enthält, die von anderen Legendentreibern vorgenommen wurden. Es gibt Informationen zu früheren Versionen, wenn das previousVersion-Element nicht NULL ist. Um den vollständigen Versionsverlauf zu untersuchen, muss der Legendentreiber weiterhin den previousVersion-Member jeder Struktur in der Liste untersuchen, bis ein Knoten gefunden wird, auf dem dieser Member auf den Wert NULL festgelegt ist.