IOControlCode Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die von der IOControl(Int32, Byte[], Byte[])-Methode unterstützten E/A-Steuercodes an.
public enum class IOControlCode
public enum IOControlCode
type IOControlCode =
Public Enum IOControlCode
- Vererbung
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| EnableCircularQueuing | 671088642 | Ersetzen Sie das älteste in die Warteschlange eingereihte Datagramm durch ein eingehendes Datagramm, wenn die eingehenden Nachrichtenwarteschlangen voll sind. Dieser Wert ist gleich der Winsock 2-SIO_ENABLE_CIRCULAR_QUEUEING Konstante. |
| Flush | 671088644 | Verwerfen Sie den Inhalt der sendenden Warteschlange. Dieser Wert ist gleich der Winsock 2-SIO_FLUSH Konstante. |
| AddressListChange | 671088663 | Aktivieren Sie den Empfang von Benachrichtigungen, wenn sich die Liste der lokalen Schnittstellen für die Protokollfamilie des Sockets ändert. Dieser Wert ist gleich der Winsock 2-SIO_ADDRESS_LIST_CHANGE Konstante. |
| DataToRead | 1074030207 | Gibt die Anzahl der für das Lesen verfügbaren Bytes zurück. Dieser Wert ist gleich der Winsock 2 FIONREAD-Konstante. |
| OobDataRead | 1074033415 | Geben Sie Informationen zu Out-of-Band-Daten zurück, die auf den Empfang warten. Wenn Sie diesen Steuerelementcode für Datenstromsockets verwenden, gibt der Rückgabewert die Anzahl der verfügbaren Bytes an. |
| GetBroadcastAddress | 1207959557 | Gibt eine SOCKADDR-Struktur zurück, die die Übertragungsadresse für die Adressfamilie des aktuellen Sockets enthält. Die zurückgegebene Adresse kann mit der SendTo Methode verwendet werden. Dieser Wert ist gleich der Winsock 2-SIO_GET_BROADCAST_ADDRESS Konstante. Dieser Wert kann nur für UDP-Sockets (User Datagram Protocol) verwendet werden. |
| AddressListQuery | 1207959574 | Gibt die Liste der lokalen Schnittstellen zurück, an die der Socket gebunden werden kann. Dieser Wert ist gleich der Winsock 2-SIO_ADDRESS_LIST_QUERY Konstante. |
| QueryTargetPnpHandle | 1207959576 | Rufen Sie das SOCKET-Handle des zugrunde liegenden Anbieters ab. Dieses Handle kann zum Empfangen von Plug-and-Play-Ereignisbenachrichtigungen verwendet werden. Dieser Wert ist gleich der Winsock 2 SIO_QUERY_TARGET_PNP_HANDLE Konstante. |
| AsyncIO | 2147772029 | Aktivieren Sie die Benachrichtigung, wann Daten empfangen werden sollen. Dieser Wert ist gleich der Winsock 2 FIOASYNC-Konstante. |
| NonBlockingIO | 2147772030 | Steuern des Blockierungsverhaltens des Sockets. Wenn das mit diesem Steuerelementcode angegebene Argument null ist, wird der Socket im Blockierungsmodus platziert. Wenn das Argument ungleich Null ist, wird der Socket im Nichtblockierungsmodus platziert. Dieser Wert ist gleich der Winsock 2 FIONBIO-Konstante. |
| AssociateHandle | 2281701377 | Ordnen Sie diesen Socket dem angegebenen Handle einer Begleitschnittstelle zu. Weitere Details finden Sie im entsprechenden protokollspezifischen Anhang in der Winsock 2-Referenz oder -Dokumentation für die jeweilige Begleitschnittstelle. Es wird empfohlen, das Component Object Model (COM) anstelle dieses IOCTL zu verwenden, um andere Schnittstellen zu ermitteln und nachzuverfolgen, die möglicherweise von einem Socket unterstützt werden. Dieser Steuerelementcode ist für die Abwärtskompatibilität mit Systemen vorhanden, auf denen COM nicht verfügbar ist oder aus einem anderen Grund nicht verwendet werden kann. Dieser Wert ist gleich der Winsock 2-SIO_ASSOCIATE_HANDLE Konstante. |
| MultipointLoopback | 2281701385 | Steuern, ob multicast-Daten, die vom Socket gesendet werden, als eingehende Daten in der Sockets-Empfangswarteschlange angezeigt werden. Dieser Wert ist gleich der Winsock 2-SIO_MULTIPOINT_LOOPBACK Konstante. |
| MulticastScope | 2281701386 | Steuern Sie, wie oft ein Multicastpaket von einem Router weitergeleitet werden kann, auch bekannt als Time to Live (TTL) oder Hop-Anzahl. Dieser Wert ist gleich der Winsock 2-SIO_MULTICAST_SCOPE Konstante. |
| SetQos | 2281701387 | Legen Sie die QOS-Attribute (Quality of Service) für den Socket fest. QOS definiert die Bandbreitenanforderungen für den Socket. Dieser Wert ist gleich der Winsock 2-SIO_SET_QOS Konstante. |
| SetGroupQos | 2281701388 | Legen Sie die QOS-Attribute (Quality of Service) für die Socketgruppe fest. Dieser Wert ist für die zukünftige Verwendung reserviert und entspricht der Winsock 2-SIO_SET_GROUP_QOS Konstante. |
| RoutingInterfaceChange | 2281701397 | Aktivieren Sie den Empfang von Benachrichtigungen, wenn sich die lokale Schnittstelle für den Zugriff auf einen Remoteendpunkt ändert. Dieser Wert ist gleich der Winsock 2-SIO_ROUTING_INTERFACE_CHANGE Konstante. |
| NamespaceChange | 2281701401 | Steuern, ob der Socket eine Benachrichtigung empfängt, wenn eine Namespaceabfrage ungültig wird. Dieser Steuerelementcode wird unter Windows XP und höheren Betriebssystemen unterstützt. Dieser Wert ist gleich der Winsock 2-SIO_NSP_NOTIFY_CHANGE Konstante. |
| ReceiveAll | 2550136833 | Aktivieren des Empfangens aller IPv4-Pakete im Netzwerk. Der Socket muss über die Adressfamilie InterNetworkverfügen, der Sockettyp muss sein Raw, und der Protokolltyp muss sein IP. Der aktuelle Benutzer muss zur Gruppe "Administratoren" auf dem lokalen Computer gehören, und der Socket muss an einen bestimmten Port gebunden sein. Dieser Wert ist gleich der Winsock 2-SIO_RCVALL Konstante. |
| ReceiveAllMulticast | 2550136834 | Aktivieren des Empfangens aller Multicast-IPv4-Pakete im Netzwerk. Hierbei handelt es sich um Pakete mit Zieladressen im Bereich 224.0.0.0 bis 239.255.255.255.255. Der Socket muss über die Adressfamilie InterNetworkverfügen, der Sockettyp muss sein Raw, und der Protokolltyp muss sein Udp. Der aktuelle Benutzer muss zur Gruppe "Administratoren" auf dem lokalen Computer gehören, und der Socket muss an einen bestimmten Port gebunden sein. Dieser Wert ist gleich der Winsock 2-SIO_RCVALL_MCAST Konstante. |
| ReceiveAllIgmpMulticast | 2550136835 | Aktivieren des Empfangens aller IGMP-Pakete (Internet Group Management Protocol) im Netzwerk. Der Socket muss über die Adressfamilie InterNetworkverfügen, der Sockettyp muss sein Raw, und der Protokolltyp muss sein Igmp. Der aktuelle Benutzer muss zur Gruppe "Administratoren" auf dem lokalen Computer gehören, und der Socket muss an einen bestimmten Port gebunden sein. Dieser Wert ist gleich der Winsock 2-SIO_RCVALL_IGMPMCAST Konstante. |
| KeepAliveValues | 2550136836 | Steuern Sie das Senden von TCP-Keep-Alive-Paketen und das Intervall, in dem sie gesendet werden. Weitere Informationen finden Sie unter RFC 1122 Section 4.2.3.6. Dieser Wert ist gleich der Winsock 2-SIO_KEEPALIVE_VALS Konstante. |
| AbsorbRouterAlert | 2550136837 | Dieser Wert ist gleich der Winsock 2-SIO_ABSORB_RTRALERT Konstante. |
| UnicastInterface | 2550136838 | Legen Sie die Schnittstelle fest, die für ausgehende Unicastpakete verwendet wird. Dieser Wert ist gleich der Winsock 2-SIO_UCAST_IF Konstante. |
| LimitBroadcasts | 2550136839 | Dieser Wert ist gleich der Winsock 2-SIO_LIMIT_BROADCASTS Konstante. |
| BindToInterface | 2550136840 | Binden Sie den Socket an einen angegebenen Schnittstellenindex. Dieser Wert ist gleich der Winsock 2-SIO_INDEX_BIND Konstante. |
| MulticastInterface | 2550136841 | Legen Sie die Schnittstelle fest, die für ausgehende Multicastpakete verwendet wird. Die Schnittstelle wird durch ihren Index identifiziert. Dieser Wert ist gleich der Winsock 2-SIO_INDEX_MCASTIF Konstante. |
| AddMulticastGroupOnInterface | 2550136842 | Verbinden einer Multicastgruppe mithilfe einer schnittstelle, die durch den Index identifiziert wird. Dieser Wert ist gleich der Winsock 2-SIO_INDEX_ADD_MCAST Konstante. |
| DeleteMulticastGroupFromInterface | 2550136843 | Entfernen Sie den Socket aus einer Multicastgruppe. Dieser Wert ist gleich der Winsock 2-SIO_INDEX_ADD_MCAST Konstante. |
| GetExtensionFunctionPointer | 3355443206 | Rufen Sie anbieterspezifische Funktionen ab, die nicht Teil der Winsock-Spezifikation sind. Funktionen werden mithilfe ihrer vom Anbieter zugewiesenen GUID angegeben. Dieser Wert ist gleich der Winsock 2-SIO_GET_EXTENSION_FUNCTION_POINTER Konstante. |
| GetQos | 3355443207 | Rufen Sie die QOS-Struktur ab, die dem Socket zugeordnet ist. Dieser Wert ist gleich der Winsock 2-SIO_GET_QOS Konstante. |
| GetGroupQos | 3355443208 | Gibt die QOS-Attribute (Quality of Service) für die Socketgruppe zurück. Dieser Wert ist für die zukünftige Verwendung reserviert und entspricht der Winsock 2-SIO_GET_GROUP_QOS Konstante. |
| TranslateHandle | 3355443213 | Gibt ein Handle für den Socket zurück, der im Kontext einer Begleitschnittstelle gültig ist. Dieser Wert ist gleich der Winsock 2-SIO_TRANSLATE_HANDLE Konstante. |
| RoutingInterfaceQuery | 3355443220 | Geben Sie die Schnittstellenadressen zurück, die zum Herstellen einer Verbindung mit der angegebenen Remoteadresse verwendet werden können. Dieser Wert ist gleich der Winsock 2-SIO_ROUTING_INTERFACE_QUERY Konstante. |
| AddressListSort | 3355443225 | Sortieren Sie die vom AddressListQuery Feld zurückgegebene Struktur, und fügen Sie Bereichs-ID-Informationen für IPv6-Adressen hinzu. Dieser Steuerelementcode wird unter Windows XP und höheren Betriebssystemen unterstützt. Dieser Wert ist gleich der Winsock 2-SIO_ADDRESS_LIST_SORT Konstante. |
Beispiele
Im folgenden Codebeispiel wird die IOControl(IOControlCode, Byte[], Byte[]) Methode mit einem DataToRead-Parameterwert aufgerufen und das Ergebnis mit dem Zugriff auf die Eigenschaft verglichen.Available
static void DisplayPendingByteCount(Socket s)
{
byte[] outValue = BitConverter.GetBytes(0);
// Check how many bytes have been received.
s.IOControl(IOControlCode.DataToRead, null, outValue);
uint bytesAvailable = BitConverter.ToUInt32(outValue, 0);
Console.Write("server has {0} bytes pending. ",
bytesAvailable);
Console.WriteLine("Available property says {1}.",
s.Available);
return;
}
Hinweise
Die IOControlCode Enumeration stellt benannte Werte zum Angeben von Socketbetriebsmodi bereit. Diese Werte sind die Steuerelementcodes, die an die Windows Sockets 2 (Winsock 2) WSAIoctl -Funktion übergeben werden.