PFN_WSK_LISTEN fonction de rappel (wsk.h)

Article
03/01/2024

La fonction WskListen permet à un socket de flux d’écouter les connexions entrantes à l’adresse liée du socket.

Syntaxe

PFN_WSK_LISTEN PfnWskListen;

NTSTATUS PfnWskListen(
  [in]      PWSK_SOCKET Socket,
  [in, out] PIRP Irp
)
{...}

Paramètres

[in] Socket

Pointeur vers une structure WSK_SOCKET qui spécifie l’objet socket pour le socket de flux qui écoute une connexion entrante. Ce socket doit avoir été précédemment lié à une adresse de transport locale en appelant WskBind.

[in, out] Irp

Pointeur vers un IRP alloué à l’appelant que le sous-système WSK utilise pour effectuer l’opération d’écoute de manière asynchrone. Pour plus d’informations sur l’utilisation des irps avec des fonctions WSK, consultez Utilisation des irps avec les fonctions du noyau Winsock.

Valeur retournée

WskListen retourne l’un des codes NTSTATUS suivants :

Code de retour	Description
STATUS_SUCCESS	Le socket de flux a écouté une connexion entrante avec succès. Le IRP sera terminé avec succès status.
STATUS_PENDING	L’IRP a été mis en file d’attente par le sous-système WSK, qui attend une connexion entrante sur le socket de flux.
STATUS_FILE_FORCED_CLOSED	Le socket n’est plus fonctionnel. L’IRP sera terminé avec l’échec status. L’application WSK doit appeler la fonction WskCloseSocket pour fermer le socket dès que possible.
Autres codes status	Une erreur est survenue. L’IRP sera terminé avec l’échec status.

Remarques

Une application WSK peut appeler la fonction WskListen uniquement sur un socket de flux que l’application a précédemment lié à une adresse de transport locale en appelant la fonction WskBind . Une fois que WskListen a été appelé avec succès sur un socket de flux, le socket est engagé dans un flux de socket d’écoute et ne peut plus appeler des fonctions de socket orientées connexion.