estructura WSK_INSPECT_ID (wsk.h)

La estructura WSK_INSPECT_ID especifica un identificador para una solicitud de conexión entrante en un socket de escucha.

Sintaxis

typedef struct _WSK_INSPECT_ID {
  ULONG_PTR Key;
  ULONG     SerialNumber;
} WSK_INSPECT_ID, *PWSK_INSPECT_ID;

Miembros

Key

Clave que se asigna a la solicitud de conexión entrante.

SerialNumber

Número de serie asignado a la solicitud de conexión entrante.

Comentarios

El subsistema WSK pasa un puntero a una estructura de WSK_INSPECT_ID a la función de devolución de llamada de eventos WSKInspectEvent de una aplicación WSK cada vez que llega una solicitud de conexión entrante en un socket de escucha que tiene habilitado el modo de aceptación condicional. El contenido de la estructura WSK_INSPECT_ID identifica de forma única la solicitud de conexión entrante.

Si la aplicación WSK devuelve WskInspectPend desde una llamada a su función de devolución de llamada de evento WskInspectEvent , la aplicación primero debe copiar el contenido de la estructura WSK_INSPECT_ID proporcionada por el subsistema WSK en su propia estructura de WSK_INSPECT_ID. A continuación, la aplicación WSK pasa un puntero a su estructura de WSK_INSPECT_ID a la función WskInspectComplete cuando completa la inspección.

Si el sistema remoto quita la solicitud de conexión entrante mientras está pendiente una operación de inspección, el subsistema WSK llama a la función de devolución de llamada de eventos WskAbortEvent de la aplicación WSK con un puntero a una estructura de WSK_INSPECT_ID que identifica la solicitud descartada. La aplicación WSK usa el contenido de esta estructura de WSK_INSPECT_ID para determinar qué inspección de una solicitud de conexión entrante se debe finalizar. La aplicación WSK debe comparar el contenido de las estructuras de WSK_INSPECT_ID para comprobar si hay coincidencias. Los valores reales de los miembros de la estructura son irrelevantes.

Una aplicación WSK puede habilitar el modo de aceptación condicional en un socket de escucha habilitando la opción de socket SO_CONDITIONAL_ACCEPT . Para obtener más información sobre cómo aceptar condicionalmente las conexiones entrantes, consulte Escucha y aceptación de Connections entrantes.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado wsk.h (incluya Wsk.h)

Consulte también

SO_CONDITIONAL_ACCEPT

WskAbortEvent

WskInspectComplete

WskInspectEvent