WSK_INSPECT_ID structure (wsk.h)

La structure WSK_INSPECT_ID spécifie un identificateur pour une demande de connexion entrante sur un socket d’écoute.

Syntaxe

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

Membres

Key

Clé affectée à la demande de connexion entrante.

SerialNumber

Numéro de série affecté à la demande de connexion entrante.

Remarques

Le sous-système WSK transmet un pointeur vers une structure WSK_INSPECT_ID à la fonction de rappel d’événement WskInspectEvent d’une application WSK chaque fois qu’une demande de connexion entrante arrive sur un socket d’écoute pour lequel le mode d’acceptation conditionnelle est activé. Le contenu de la structure WSK_INSPECT_ID identifie de manière unique la demande de connexion entrante.

Si l’application WSK renvoie WskInspectPend à partir d’un appel à sa fonction de rappel d’événement WskInspectEvent , l’application doit d’abord copier le contenu de la structure WSK_INSPECT_ID fournie par le sous-système WSK dans sa propre structure WSK_INSPECT_ID. L’application WSK passe ensuite un pointeur vers sa structure WSK_INSPECT_ID à la fonction WskInspectComplete lorsqu’elle termine l’inspection.

Si la demande de connexion entrante est supprimée par le système distant alors qu’une opération d’inspection est en attente, le sous-système WSK appelle la fonction de rappel d’événement WskAbortEvent de l’application WSK avec un pointeur vers une structure WSK_INSPECT_ID qui identifie la demande supprimée. L’application WSK utilise le contenu de cette structure WSK_INSPECT_ID pour déterminer quelle inspection d’une demande de connexion entrante doit être terminée. L’application WSK doit comparer le contenu des structures WSK_INSPECT_ID à case activée pour obtenir une correspondance. Les valeurs réelles des membres de la structure ne sont pas pertinentes.

Une application WSK peut activer le mode d’acceptation conditionnelle sur un socket d’écoute en activant l’option de socket SO_CONDITIONAL_ACCEPT . Pour plus d’informations sur l’acceptation conditionnelle des connexions entrantes, consultez Écoute et acceptation des Connections entrantes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	wsk.h (inclure Wsk.h)

Voir aussi

SO_CONDITIONAL_ACCEPT

WskAbortEvent

WskInspectComplete

WskInspectEvent