WSK_TRANSPORT_LIST_QUERY
Une application WSK utilise l’opération de contrôle client WSK_TRANSPORT_LIST_QUERY pour récupérer une liste de transports réseau disponibles qui peuvent être spécifiés lors de la création d’un socket.
Pour récupérer la liste des transports réseau disponibles, une application WSK appelle la fonction WskControlClient avec les paramètres suivants.
Paramètre | Valeur |
---|---|
ControlCode |
WSK_TRANSPORT_LIST_QUERY |
InputSize |
0 |
InputBuffer |
NULL |
OutputSize |
Taille, en octets, du tableau de structures vers lequel pointe le paramètre OutputBuffer |
OutputBuffer |
Pointeur vers un tableau de structures WSK_TRANSPORT qui reçoit la liste des transports réseau disponibles |
OutputSizeReturned |
Pointeur vers une variable de type SIZE_T qui reçoit le nombre d’octets de données copiées dans le tableau de structures vers lequel pointe le paramètre OutputBuffer |
Irp |
NULL |
Une application WSK peut spécifier zéro dans le paramètre OutputSize et NULL dans le paramètre OutputBuffer pour déterminer la taille du tableau de structures WSK_TRANSPORT , en octets, requise pour contenir la liste complète des transports réseau disponibles. Dans ce cas, l’appel à la fonction WskControlClient retourne STATUS_BUFFER_OVERFLOW, et la variable vers laquelle pointe le paramètre OutputSizeReturned contient la taille de mémoire tampon requise. L’application peut ensuite allouer une mémoire tampon suffisamment grande pour contenir la liste complète des transports réseau disponibles et peut appeler la fonction WskControlClient une deuxième fois, en spécifiant les paramètres affichés dans le tableau précédent.
Le paramètre Irp doit être NULL pour cette opération de contrôle client.
Spécifications
Version |
Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
En-tête |
Wsk.h (inclure Wsk.h) |