Fonction WskRegister (wsk.h)

  • Article

La fonction WskRegister inscrit une application WSK, en fonction de l’interface de programmation réseau (NPI) du client WSK de l’application.

Syntaxe

NTSTATUS WskRegister(
  [in]  PWSK_CLIENT_NPI   WskClientNpi,
  [out] PWSK_REGISTRATION WskRegistration
);

Paramètres

[in] WskClientNpi

Pointeur vers l’indicateur NPI client implémenté par l’application WSK.

[out] WskRegistration

Pointeur vers un emplacement de mémoire qui identifie le instance d’inscription d’une application WSK. Cet emplacement de mémoire sera initialisé par l’appel WskRegister et sera utilisé par les autres fonctions d’inscription WSK. L’application WSK ne doit jamais modifier directement le contenu de cet emplacement de mémoire.

Valeur retournée

WskRegister retourne l’un des codes NTSTATUS suivants :

Code de retour Description
STATUS_SUCCESS
 L’inscription a réussi.
Autres codes status
 L’inscription a échoué.

Remarques

Un objet client WSK peut appeler cette fonction plusieurs fois, mais un paramètre WskRegistration différent doit être utilisé pour chaque appel afin de créer plusieurs instances d’inscription.

Pour chaque appel à WskRegister qui retourne un code de réussite, il doit y avoir exactement un appel WskDeregister correspondant qui utilise le même paramètre WskRegistration qui a été passé à WskRegister.

Le bloc de mémoire pointé par WskRegistration doit rester alloué (ne doit pas être libéré ou sortir de l’étendue) tant qu’il y a des appels en attente vers d’autres fonctions d’inscription WSK.

L’utilisation des fonctions WskRegister et WskDeregister est la méthode recommandée pour inscrire et annuler l’inscription d’applications WSK. Le serveur d’enregistrement de modules réseau reste disponible pour des fins de compatibilité.

Pour plus d’informations sur l’attachement d’une application WSK au sous-système WSK, consultez Inscription d’une application de noyau Winsock.

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)
Bibliothèque Netio.lib
IRQL PASSIVE_LEVEL

Voir aussi

WSK_CLIENT_NPI

WSK_REGISTRATION

WskDeregister