estructura FWPS_TRANSPORT_SEND_PARAMS0 (fwpsk.h)

Artículo
02/26/2024

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

NotaFWPS_TRANSPORT_SEND_PARAMS0 es la versión específica de FWPS_TRANSPORT_SEND_PARAMS usada en Windows Vista y versiones posteriores. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios. Para Windows 7, FWPS_TRANSPORT_SEND_PARAMS1 está disponible.

Sintaxis

typedef struct FWPS_TRANSPORT_SEND_PARAMS0_ {
  UCHAR      *remoteAddress;
  SCOPE_ID   remoteScopeId;
  WSACMSGHDR *controlData;
  ULONG      controlDataLength;
} FWPS_TRANSPORT_SEND_PARAMS0;

Miembros

remoteAddress

Puntero a un búfer que especifica la dirección IP remota a la que se va a 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 classifyFn del controlador de llamada.

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 FwpsInjectTransportSendAsync0 .

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 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 , vea 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, se deben copiar 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 inyección.

controlDataLength

Longitud, en bytes, del miembro controlData .