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) |