FWPS_CONNECT_REQUEST0 Struktur (fwpsk.h)

Artikel
02/07/2025

Die FWPS_CONNECT_REQUEST0-Struktur definiert modifizierbare Daten für die FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V4- und FWPM_LAYER_ALE_AUTH_CONNECT_REDIRECT_V6-Ebenen. Der Popuptreiber verwendet diese Daten, um die Verbindungsinformationen zu prüfen oder zu ändern.

HinweisFWPS_CONNECT_REQUEST0 ist eine bestimmte Version von FWPS_CONNECT_REQUEST. Weitere Informationen finden Sie unter WFP-Version-Independent Namen und zielspezifische Versionen von Windows.

Syntax

typedef struct _FWPS_CONNECT_REQUEST0 {
  SOCKADDR_STORAGE              localAddressAndPort;
  SOCKADDR_STORAGE              remoteAddressAndPort;
  UINT64                        portReservationToken;
  DWORD                         localRedirectTargetPID;
  struct _FWPS_CONNECT_REQUEST0 *previousVersion;
  UINT64                        modifierFilterId;
  HANDLE                        localRedirectHandle;
  void                          *localRedirectContext;
  SIZE_T                        localRedirectContextSize;
} FWPS_CONNECT_REQUEST0;

Angehörige

localAddressAndPort

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

remoteAddressAndPort

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

portReservationToken

Ein Token, das zum Reservieren des entsprechenden Ports verwendet wird. Das Token wird abgerufen, wenn ein Port reserviert wird, indem entweder CreatePersistentTcpPortReservation oder CreatePersistentUdpPortReservationaufgerufen wird.

localRedirectTargetPID

Der Prozessbezeichner des lokalen Hostprozesses, der Datenverkehr an die in localAddressAndPortangegebene Adresse verarbeitet. Dieser Wert muss für Loopbackumleitungsänderungen festgelegt werden, die vom Modul akzeptiert werden.

previousVersion

Die vorherige Version der Verbindungsanforderungsdaten. Dieses schreibgeschützte Feld zeichnet den Änderungsverlauf der Verbindungsanforderung auf. Wenn die Verbindungsanforderungsdaten noch nicht von einem anderen WFP-Filter geändert wurden, wird previousVersion- auf NULL-festgelegt.

modifierFilterId

Der Wert des FilterId Member des klassifizierenFnFilterparameters der Funktion. Weitere Informationen zum element FilterId finden Sie unter FWPS_FILTER1.

localRedirectHandle

Das Umleitungshandle, das der beschriftete Treiber erstellt hat, indem die FwpsRedirectHandleCreate0-Funktion aufgerufen wird.

Hinweis Ab Windows 8 muss die localRedirectHandle- aufgefüllt werden, damit die Umleitung funktioniert.

localRedirectContext

Ein Beschriftungstreiberkontextbereich, den der Beschriftungstreiber zugeordnet hat, indem die funktion ExAllocatePoolWithTag aufgerufen wird.

Hinweis Ab Windows 8 wird ab Windows 8 arbeitsspeicher, der für localRedirectContext- zugewiesen wurde, den Besitz von WFP erhalten und beim Entfernen des proxiierten Flusses freigegeben.

localRedirectContextSize

Die Größe des vom Popup bereitgestellten Kontextbereichs in Bytes.

Hinweis Ab Windows 8 unterstützt.

Bemerkungen

Der Beschriftungstreiber ruft diese Struktur durch Aufrufen der FwpsAcquireWritableLayerDataPointer0 Funktion, die einen Zeiger auf eine FWPS_CONNECT_REQUEST0 Struktur über den writableLayerData-Parameter zurückgibt. Die klassifizierenFn Funktion kann die Parameter der Verbindungsanforderung ändern, z. B. die Lokale oder Remotetransportadresse oder den Port an eine andere Adresse oder einen anderen Port umleiten. Wenn die Parameter der Verbindungsanforderung geändert werden, muss die klassifizierenFn-Funktion Folgendes ausführen:

Nehmen Sie alle Änderungen an der FWPS_CONNECT_REQUEST0 Struktur vor, die von FwpsAcquireWritableLayerDataPointer0zurückgegeben wurde. Nur die remoteAddressAndPort, portReservationToken, localRedirectTargetPID, localRedirectHandle, localRedirectContextund localRedirectContextSize Member können geändert werden.
Rufen FwpsApplyModifiedLayerData0 mit dem parameter "modifiedLayerData" auf die Adresse der FWPS_CONNECT_REQUEST0 Struktur festgelegt, auch wenn der Legendentreiber keine Daten geändert hat. Dieser Wert muss mit dem modifiedLayerData- Parameterwert identisch sein, der durch FwpsAcquireWritableLayerDataPointer0.

Diese Struktur fungiert als verknüpfte Liste, die einen Datensatz aller Änderungen enthält, die von anderen Legendentreibern vorgenommen wurden. Es gibt Informationen zur vorherigen Version, wenn das previousVersion Member nicht NULL-ist. Um den vollständigen Versionsverlauf zu untersuchen, muss der Legendentreiber weiterhin das previousVersion Member jeder Struktur in der Liste überprüfen, bis sie auf NULL-festgelegt ist.