FWPS_BIND_REQUEST0 구조체(fwpsk.h)

아티클
02/29/2024

FWPS_BIND_REQUEST0 구조는 FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4 및 FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6 계층에 대한 수정 가능한 데이터를 정의합니다. 콜아웃 드라이버는 이 데이터를 사용하여 연결 정보를 검사하거나 수정합니다.

FWPS_BIND_REQUEST0 특정 버전의 FWPS_BIND_REQUEST. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요.

구문

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

멤버

localAddressAndPort

바인딩 요청의 로컬 전송 주소입니다. IPV4 또는 IPV6 주소이며 SOCKADDR_STORAGE 구조로 형식이 지정된 TCP/UDP 포트입니다.

portReservationToken

적절한 포트를 예약하는 데 사용되는 토큰입니다. 토큰은 CreatePersistentTcpPortReservation 또는 CreatePersistentUdpPortReservation을 호출하여 포트를 예약할 때 가져옵니다. 두 예약 함수는 모두 iphlpapi.h에서 찾을 수 있습니다.

previousVersion

바인딩 요청 데이터의 이전 버전입니다. 이 읽기 전용 필드는 바인딩 요청의 수정 기록을 기록합니다. 이 멤버는 현재 FWPS_BIND_REQUEST0 데이터에 대한 레코드로 설정된 인덱스가 있는 singly 연결된 목록에 대한 포인터를 사용하여 미리 초기화됩니다.

modifierFilterId

classifyFn 함수의 filter 매개 변수에 대한 FilterId 멤버의 값 입니다. FilterId 멤버에 대한 자세한 내용은 FWPS_FILTER1.

설명

설명선 드라이버는 를 호출하여 이 구조를 가져옵니다.WritableLayerData 매개 변수를 통해 FWPS_BIND_REQUEST0 구조체에 대한 포인터를 반환하는 FwpsAcquireWritableLayerDataPointer0 함수입니다.

classifyFn 함수는 로컬 전송 주소 또는 포트를 다른 주소 또는 포트로 리디렉션하는 등 바인딩 요청의 매개 변수를 수정할 수 있습니다. 바인딩 요청의 매개 변수를 수정하는 경우
classifyFn 함수는 다음을 수행해야 합니다.

FwpsAcquireWritableLayerDataPointer0에서 반환된 FWPS_BIND_REQUEST0 구조체를 모두 변경합니다. localAddressAndPort 및 portReservationToken 멤버만 수정할 수 있습니다.
호출설명선 드라이버가 데이터를 수정하지 않은 경우에도 modifiedLayerData 매개 변수가 FWPS_BIND_REQUEST0 구조체의 주소로 설정된 FwpsApplyModifiedLayerData0입니다. 이 값은 에서 반환된 modifiedLayerData 매개 변수 값과 동일해야 합니다. FwpsAcquireWritableLayerDataPointer0.

이 구조체는 다른 설명선 드라이버의 모든 변경 내용에 대한 레코드를 포함하는 연결된 목록으로 작동합니다. previousVersion 멤버가 NULL이 아닌 경우 이전 버전 정보가 있습니다. 전체 버전 기록을 검사하려면 설명선 드라이버가 이 멤버가 NULL 값으로 설정된 노드를 발견할 때까지 목록에서 각 구조체의 previousVersion 멤버를 계속 검사해야 합니다.