structure WSK_INSPECT_ID (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 vers la fonction de rappel d’événement WskInspectEvent WskInspectEvent chaque fois qu’une demande de connexion entrante arrive sur un socket d’écoute activé. Le contenu de la structure WSK_INSPECT_ID identifie de manière unique la demande de connexion entrante.
Si l’application WSK retourne WskInspectPend d’un appel à sa fonction de rappel d’événements 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 transmet ensuite un pointeur à 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 pendant qu’une opération d’inspection est en attente, le sous-système WSK appelle la fonction de rappel d’événement WSK WskAbortEvent 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 l’inspection d’une demande de connexion entrante qui doit être arrêtée. L’application WSK doit comparer le contenu des structures WSK_INSPECT_ID pour rechercher 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 l’écoute et l’acceptation des connexions entrantes.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | wsk.h (include Wsk.h) |