Fonction WskRegister (wsk.h)
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 |
|---|---|
|
L’inscription a réussi. |
|
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 |