Partager via


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)