PFN_WSK_BIND fonction de rappel (wsk.h)

Article
02/27/2024

La fonction WskBind lie un socket à une adresse de transport locale.

Syntaxe

PFN_WSK_BIND PfnWskBind;

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

Paramètres

[in] Socket

Pointeur vers une structure WSK_SOCKET qui spécifie l’objet socket pour le socket lié.

[in] LocalAddress

Pointeur vers une structure qui spécifie l’adresse de transport locale à laquelle lier 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é à l’utilisation du 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 terminer l’opération de liaison 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

WskBind retourne l’un des codes NTSTATUS suivants :

Code de retour	Description
STATUS_SUCCESS	Le socket a été lié avec succès à l’adresse de transport locale. Le IRP sera terminé avec succès status.
STATUS_PENDING	Le sous-système WSK n’a pas pu lier le socket immédiatement. Le sous-système WSK termine l’IRP une fois qu’il a lié le socket à l’adresse de transport locale. Le status de l’opération de liaison sera retourné 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

Pour un socket d’écoute, l’appel de la fonction WskBind prépare le socket à écouter les demandes de connexion entrantes sur l’adresse de transport locale spécifiée. Si une application WSK spécifie une adresse générique locale, le socket écoute les demandes de connexion entrantes sur toutes les adresses de transport locales.

Pour un socket de datagramme, l’appel de la fonction WskBind prépare le socket pour envoyer et recevoir des datagrammes sur l’adresse de transport locale spécifiée. Si une application WSK spécifie une adresse générique locale, le socket reçoit des datagrammes sur toutes les adresses de transport locales et envoie des datagrammes à partir de l’adresse de transport locale appropriée qui est déterminée par les informations de routage du système.

Pour un socket orienté connexion, l’appel de la fonction WskBind lie le socket à l’adresse de transport locale spécifiée. WskBind doit être appelé avant d’appeler la fonction WskConnect . Si une application WSK spécifie une adresse générique locale, la pile réseau lie le socket à l’adresse de transport locale appropriée lorsque l’application appelle WskConnect pour connecter le socket à une adresse de transport distante. Dans ce cas, l’adresse de transport locale est déterminée par les informations de routage du système.

Pour un socket de flux, l’appel de la fonction WskBind lie le socket à l’adresse de transport locale spécifiée. Si une application WSK spécifie une adresse générique locale, la pile réseau lie le socket à une adresse de transport locale disponible. WskBind doit être appelé avant d’appeler les fonctions WskListen ou WskConnect .

Configuration requise

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