WskRegister, fonction (wsk.h)
La fonction WskRegister inscrit une application WSK, en fonction du client WSK de l’application L’interface NPI (Network Programming Interface)de l’application.
Syntaxe
NTSTATUS WskRegister(
[in] PWSK_CLIENT_NPI WskClientNpi,
[out] PWSK_REGISTRATION WskRegistration
);
Paramètres
[in] WskClientNpi
Pointeur vers l’indicateur de performance réseau client implémenté par l’application WSK.
[out] WskRegistration
Pointeur vers un emplacement de mémoire qui identifie l’instance d’inscription d’une application WSK. Cet emplacement de mémoire est 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 de retour
WskRegister retourne l’un des codes NTSTATUS suivants :
| Retourner le code | Description |
|---|---|
|
L’inscription a réussi. |
|
Échec de l’inscription. |
Remarques
Un objet client WSK peut appeler cette fonction plusieurs fois, mais un autre paramètre WskRegistration 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 signalé par WskRegistration doit être alloué (ne doit pas être libéré ou sortir de portée) tant qu’il existe des appels en attente à 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 bureau d’enregistrement de modules réseau reste disponible pour la 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Universel |
| d’en-tête | wsk.h (include Wsk.h) |
| bibliothèque | Netio.lib |
| IRQL | PASSIVE_LEVEL |