WSK_TRANSPORT_LIST_QUERY

Eine WSK-Anwendung verwendet den WSK_TRANSPORT_LIST_QUERY Clientsteuerungsvorgang, um eine Liste der verfügbaren Netzwerktransporte abzurufen, die beim Erstellen eines neuen Sockets angegeben werden können.

Um eine Liste der verfügbaren Netzwerktransporte abzurufen, ruft eine WSK-Anwendung die WskControlClient-Funktion mit den folgenden Parametern auf.

Parameter Wert

ControlCode

WSK_TRANSPORT_LIST_QUERY

InputSize

0

Inputbuffer

NULL

OutputSize

Die Größe des Arrays von Strukturen in Bytes, auf das der OutputBuffer-Parameter verweist

OutputBuffer

Ein Zeiger auf ein Array von WSK_TRANSPORT Strukturen, das die Liste der verfügbaren Netzwerktransporte empfängt

OutputSizeReturned

Ein Zeiger auf eine SIZE_T typisierte Variable, die die Anzahl der Bytes von Daten empfängt, die in das Array von Strukturen kopiert werden, auf das der OutputBuffer-Parameter verweist

Irp

NULL

Eine WSK-Anwendung kann null im OutputSize-Parameter und NULL im OutputBuffer-Parameter angeben, um die Größe des Arrays von WSK_TRANSPORT Strukturen in Bytes zu bestimmen, das erforderlich ist, um die vollständige Liste der verfügbaren Netzwerktransporte zu enthalten. In einer solchen Situation gibt der Aufruf der WskControlClient-Funktion STATUS_BUFFER_OVERFLOW zurück, und die Variable, auf die vom OutputSizeReturned-Parameter verwiesen wird, enthält die erforderliche Puffergröße. Die Anwendung kann dann einen Puffer zuordnen, der groß genug ist, um die vollständige Liste der verfügbaren Netzwerktransporte zu enthalten, und kann die WskControlClient-Funktion ein zweites Mal aufrufen und die Parameter angeben, die in der vorherigen Tabelle angezeigt werden.

Der Irp-Parameter muss für diesen Clientsteuerungsvorgang NULL sein.

Requirements (Anforderungen)

Version

Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.

Header

Wsk.h (einschließen von Wsk.h)