PFN_WSK_CONNECT fonction de rappel (wsk.h)

Article
03/01/2024

La fonction WskConnect connecte un socket orienté connexion ou flux à une adresse de transport distante.

Syntaxe

PFN_WSK_CONNECT PfnWskConnect;

NTSTATUS PfnWskConnect(
  [in]      PWSK_SOCKET Socket,
  [in]      PSOCKADDR RemoteAddress,
            ULONG Flags,
  [in, out] PIRP Irp
)
{...}

Paramètres

[in] Socket

Pointeur vers une structure de WSK_SOCKET qui spécifie l’objet socket pour le socket connecté à une adresse de transport distante.

[in] RemoteAddress

Pointeur vers une structure qui spécifie l’adresse de transport distante à laquelle connecter le socket. Ce pointeur doit être un pointeur vers le type de structure SOCKADDR spécifique qui correspond à la famille d’adresses spécifiée par l’application WSK lors de la création du socket.

Flags

Ce paramètre est réservé à une utilisation système. Une application WSK doit définir ce paramètre sur zéro.

[in, out] Irp

Pointeur vers un IRP alloué à l’appelant que le sous-système WSK utilise pour effectuer l’opération de connexion de façon asynchrone. Pour plus d’informations sur l’utilisation des runtimes d’intégration avec les fonctions WSK, consultez Utilisation des runtimes d’intégration avec les fonctions du noyau Winsock.

Valeur retournée

WskConnect retourne l’un des codes NTSTATUS suivants :

Code de retour	Description
STATUS_SUCCESS	Le socket a été correctement connecté à l’adresse de transport distante. L’IRP sera complété avec succès status.
STATUS_PENDING	Le sous-système WSK n’a pas pu connecter le socket immédiatement. Le sous-système WSK termine l’IRP après avoir connecté le socket à l’adresse de transport distante. La status de l’opération de connexion est retournée dans le champ IoStatus.Status de l’IRP.
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 WskConnect uniquement sur un socket orienté connexion ou de flux que l’application a précédemment lié à une adresse de transport locale en appelant la fonction WskBind .

Pour les sockets de flux, une fois que WskConnect est correctement appelé sur un socket de flux, le socket est commité dans un flux orienté connexion et peut ne plus appeler les fonctions de socket d’écoute.

Une application WSK peut créer, lier et connecter un socket orienté connexion dans un seul appel de fonction en appelant la fonction WskSocketConnect au lieu d’appeler la fonction WskSocket , la fonction WskBind , puis la fonction WskConnect . Nous vous recommandons d’appeler la fonction WskSocketConnect , sauf si l’application WSK doit définir une option de socket ou émettre une opération de contrôle d’E/S avant de lier ou de connecter le socket.

Configuration requise

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