estructura FWPS_TRANSPORT_SEND_PARAMS1 (fwpsk.h)

Artículo
08/07/2023

La estructura FWPS_TRANSPORT_SEND_PARAMS1 define las propiedades de un paquete de capa de transporte de salida.

NotaFWPS_TRANSPORT_SEND_PARAMS1 es la versión específica de FWPS_TRANSPORT_SEND_PARAMS usada en Windows 7 y versiones posteriores. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows . Para Windows Vista, FWPS_TRANSPORT_SEND_PARAMS0 está disponible.

Sintaxis

typedef struct FWPS_TRANSPORT_SEND_PARAMS1_ {
  UCHAR      *remoteAddress;
  SCOPE_ID   remoteScopeId;
  WSACMSGHDR *controlData;
  ULONG      controlDataLength;
  UCHAR      *headerIncludeHeader;
  ULONG      headerIncludeHeaderLength;
} FWPS_TRANSPORT_SEND_PARAMS1;

Miembros

remoteAddress

Puntero a un búfer que especifica la dirección IP remota a la que se debe enviar el socket. La dirección remota especificada por este miembro puede ser diferente de la que se pasa como uno de los valores de datos entrantes a la función de llamada clasifique del controlador de llamadaFn.

El búfer puede contener una dirección IPv4 (4 bytes) o una dirección IPv6 (16 bytes) y la dirección debe especificarse en orden de bytes de red. La versión de IP debe coincidir con el parámetro AddressFamily especificado en . Función FwpsInjectTransportSendAsync1 .

El búfer debe permanecer válido hasta que se llame a la función de finalización de inyección.

remoteScopeId

Estructura SCOPE_ID que contiene el identificador de ámbito de la dirección IP remota. El identificador de ámbito se proporciona a una llamada a través del miembro remoteScopeId del FWPS_INCOMING_METADATA_VALUES0 estructura que se pasa a la función de llamada classifyFn del controlador de llamada. La estructura de SCOPE_ID se define en Ws2ipdef.h como se indica a continuación.

typedef struct {
  union {
    struct {
      ULONG  Zone : 28;
      ULONG  Level : 4;
    };
    ULONG  Value;
  };
} SCOPE_ID, *PSCOPE_ID;

controlData

Puntero opcional a un búfer que contiene datos de control de socket especificados por la función WSASendMsg . Para obtener información sobre el tipo WSACMSGHDR , consulte CMSGHDR.

Si está presente, los datos del control de socket se proporcionan a una llamada con el miembro controlData del FWPS_INCOMING_METADATA_VALUES0 estructura que se pasa a la función de llamada classifyFn del controlador de llamada.

Si los datos del control de socket no son NULL, deben copiarse en profundidad en la implementación del controlador de llamada de la función classifyFn y el búfer controlData debe mantenerse válido hasta que se llame a la función de finalización de la inyección.

controlDataLength

Longitud, en bytes, del miembro controlData .

headerIncludeHeader

Encabezado de transporte que se va a incluir.

headerIncludeHeaderLength

Longitud, en bytes, del miembro headerIncludeHeader .