IOControlCode Enumeration

Definition

Gibt die von der IOControl(Int32, Byte[], Byte[])-Methode unterstützten EA-Steuerungscodes an.Specifies the IO control codes supported by the IOControl(Int32, Byte[], Byte[]) method.

public enum class IOControlCode
public enum IOControlCode
type IOControlCode = 
Public Enum IOControlCode
Vererbung
IOControlCode

Felder

AbsorbRouterAlert 2550136837

Dieser Wert entspricht der SIO_ABSORB_RTRALERT-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_ABSORB_RTRALERT constant.

AddMulticastGroupOnInterface 2550136842

Verknüpfen Sie eine Multicastgruppe mithilfe einer durch diesen Index angegebenen Schnittstelle.Join a multicast group using an interface identified by its index. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_INDEX_ADD_MCAST-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_INDEX_ADD_MCAST constant.

AddressListChange 671088663

Aktiviert das Empfangen einer Benachrichtigung, wenn sich die Liste lokaler Schnittstellen für die Protokollfamilie des Sockets ändern.Enable receiving notification when the list of local interfaces for the socket's protocol family changes. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_ADDRESS_LIST_CHANGE-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_ADDRESS_LIST_CHANGE constant.

AddressListQuery 1207959574

Gibt die Liste der lokalen Schnittstellen zurück, an die der Socket gebunden werden kann.Return the list of local interfaces that the socket can bind to. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_ADDRESS_LIST_QUERY-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_ADDRESS_LIST_QUERY constant.

AddressListSort 3355443225

Sortiert die vom AddressListQuery-Feld zurückgegebene Struktur, und fügt für IPv6-Adressen Bereichs-ID-Informationen hinzu.Sort the structure returned by the AddressListQuery field and add scope ID information for IPv6 addresses. Dieser Steuerungscode wird von Windows XP und höher unterstützt.This control code is supported on Windows XP and later operating systems. Dieser Wert entspricht der SIO_ADDRESS_LIST_SORT-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_ADDRESS_LIST_SORT constant.

AssociateHandle 2281701377

Ordnet diesen Socket dem angegebenen Handle einer Begleitschnittstelle zu.Associate this socket with the specified handle of a companion interface. Weitere Informationen finden Sie im entsprechenden protokollspezifischen Annex der Winsock 2-Referenz oder -Dokumentation zur jeweiligen Begleitschnittstelle.Refer to the appropriate protocol-specific annex in the Winsock 2 reference or documentation for the particular companion interface for additional details. Es empfiehlt sich, COM (Component Object Model) anstelle von IOCTL zu verwenden, um weitere Schnittstellen zu ermitteln und nachzuverfolgen, die möglicherweise von einem Socket unterstützt werden.It is recommended that the Component Object Model (COM) be used instead of this IOCTL to discover and track other interfaces that might be supported by a socket. Dieser Steuerungscode ist für die Abwärtskompatibilität mit Systemen vorhanden, in denen COM nicht verfügbar ist oder aus einem anderen Grund nicht verwendet werden kann.This control code is present for backward compatibility with systems where COM is not available or cannot be used for some other reason. Dieser Wert entspricht der SIO_ASSOCIATE_HANDLE-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_ASSOCIATE_HANDLE constant.

AsyncIO 2147772029

Aktiviert die Benachrichtigung, wenn der Empfang von Daten aussteht.Enable notification for when data is waiting to be received. Dieser Wert entspricht der FIOASYNC-Konstante von Winsock 2.This value is equal to the Winsock 2 FIOASYNC constant.

BindToInterface 2550136840

Bindet den Socket an einen angegebenen Schnittstellenindex.Bind the socket to a specified interface index. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_INDEX_BIND-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_INDEX_BIND constant.

DataToRead 1074030207

Gibt die Anzahl der zum Lesen verfügbaren Bytes zurück.Return the number of bytes available for reading. Dieser Wert entspricht der FIONREAD-Konstante von Winsock 2.This value is equal to the Winsock 2 FIONREAD constant.

DeleteMulticastGroupFromInterface 2550136843

Entfernt den Socket aus einer Multicastgruppe.Remove the socket from a multicast group. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_INDEX_ADD_MCAST-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_INDEX_ADD_MCAST constant.

EnableCircularQueuing 671088642

Ersetzt das älteste Datagramm in der Warteschlange durch ein eingehendes Datagramm, wenn die Warteschlangen für eingehende Meldungen voll sind.Replace the oldest queued datagram with an incoming datagram when the incoming message queues are full. Dieser Wert entspricht der SIO_ENABLE_CIRCULAR_QUEUEING-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_ENABLE_CIRCULAR_QUEUEING constant.

Flush 671088644

Verwirft den Inhalt der Sendewarteschlange.Discard the contents of the sending queue. Dieser Wert entspricht der SIO_FLUSH-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_FLUSH constant.

GetBroadcastAddress 1207959557

Gibt eine SOCKADDR-Struktur zurück, die die Broadcastadresse für die Adressfamilie des aktuellen Sockets enthält.Return a SOCKADDR structure that contains the broadcast address for the address family of the current socket. Die zurückgegebene Adresse kann mit der SendTo-Methode verwendet werden.The returned address can be used with the SendTo method. Dieser Wert entspricht der SIO_GET_BROADCAST_ADDRESS-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_GET_BROADCAST_ADDRESS constant. Dieser Wert kann nur für UDP (User Datagram Protocol)-Sockets verwendet werden.This value can be used on User Datagram Protocol (UDP) sockets only.

GetExtensionFunctionPointer 3355443206

Ruft anbieterspezifische Funktionen ab, die nicht in der Winsock-Spezifikation enthalten sind.Obtain provider-specific functions that are not part of the Winsock specification. Funktionen werden mit ihrer vom Anbieter zugewiesenen GUID angegeben.Functions are specified using their provider-assigned GUID. Dieser Wert entspricht der SIO_GET_EXTENSION_FUNCTION_POINTER-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_GET_EXTENSION_FUNCTION_POINTER constant.

GetGroupQos 3355443208

Gibt die QOS (Quality of Service)-Attribute für die Socketgruppe zurück.Return the Quality of Service (QOS) attributes for the socket group. Dieser Wert ist für eine zukünftige Verwendung reserviert und entspricht der SIO_GET_GROUP_QOS-Konstante von Winsock 2.This value is reserved for future use, and is equal to the Winsock 2 SIO_GET_GROUP_QOS constant.

GetQos 3355443207

Ruft die dem Socket zugeordnete QOS-Struktur ab.Retrieve the QOS structure associated with the socket. Dieser Steuerungscode wird nur auf Plattformen unterstützt, die eine QOS-fähige Übertragung (Windows Me, Windows 2000 und höher) bereitstellen. Dieser Wert entspricht der SIO_GET_QOS-Konstante von Winsock 2.This control is only supported on platforms that provide a QOS capable transport (Windows Me, Windows 2000, and later.) This value is equal to the Winsock 2 SIO_GET_QOS constant.

KeepAliveValues 2550136836

Steuerungscode, der TCP-Keep-alive-Pakete sendet, und das Intervall, in dem die Pakete gesendet werden.Control sending TCP keep-alive packets and the interval at which they are sent. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Weitere Informationen finden Sie in RFC 1122, Abschnitt 4.2.3.6.For additional information, see RFC 1122 section 4.2.3.6. Dieser Wert entspricht der SIO_KEEPALIVE_VALS-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_KEEPALIVE_VALS constant.

LimitBroadcasts 2550136839

Dieser Wert entspricht der SIO_LIMIT_BROADCASTS-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_LIMIT_BROADCASTS constant.

MulticastInterface 2550136841

Legt die Schnittstelle für ausgehende Multicastpakete fest.Set the interface used for outgoing multicast packets. Die Schnittstelle wird durch ihren Index angegeben.The interface is identified by its index. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_INDEX_MCASTIF-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_INDEX_MCASTIF constant.

MulticastScope 2281701386

Steuert die Anzahl der Weiterleitungen eines Multicastpakets durch einen Router, auch als Gültigkeitsdauer (TTL) oder Hop Count bezeichnet.Control the number of times a multicast packet can be forwarded by a router, also known as the Time to Live (TTL), or hop count. Dieser Wert entspricht der SIO_MULTICAST_SCOPE-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_MULTICAST_SCOPE constant.

MultipointLoopback 2281701385

Steuert, ob vom Socket gesendete Multicastdaten in der Empfangswarteschlange für Sockets als eingehende Daten behandelt werden.Control whether multicast data sent by the socket appears as incoming data in the sockets receive queue. Dieser Wert entspricht der SIO_MULTIPOINT_LOOPBACK-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_MULTIPOINT_LOOPBACK constant.

NamespaceChange 2281701401

Steuert, ob der Socket eine Benachrichtigung empfängt, wenn eine Namespaceabfrage ungültig wird.Control whether the socket receives notification when a namespace query becomes invalid. Dieser Steuerungscode wird von Windows XP und höher unterstützt.This control code is supported on Windows XP and later operating systems. Dieser Wert entspricht der SIO_NSP_NOTIFY_CHANGE-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_NSP_NOTIFY_CHANGE constant.

NonBlockingIO 2147772030

Steuert das Blockierungsverhalten des Sockets.Control the blocking behavior of the socket. Wenn das mit diesem Steuerungscode angegebene Argument 0 (null) ist, wird der Socket in den blockierenden Modus versetzt.If the argument specified with this control code is zero, the socket is placed in blocking mode. Wenn das Argument ungleich 0 (null) ist, wird der Socket in den nicht blockierenden Modus versetzt.If the argument is nonzero, the socket is placed in nonblocking mode. Dieser Wert entspricht der FIONBIO-Konstante von Winsock 2.This value is equal to the Winsock 2 FIONBIO constant.

OobDataRead 1074033415

Gibt Informationen über Out-of-Band-Daten zurück, deren Empfang aussteht.Return information about out-of-band data waiting to be received. Bei Verwendung dieses Steuerungscodes für Streamsockets gibt der Rückgabewert die Anzahl der verfügbaren Bytes an.When using this control code on stream sockets, the return value indicates the number of bytes available.

QueryTargetPnpHandle 1207959576

Ruft das SOCKET-Handle des zugrunde liegenden Anbieters ab.Retrieve the underlying provider's SOCKET handle. Dieses Handle kann zum Empfangen von Plug-and-Play-Ereignisbenachrichtigungen verwendet werden.This handle can be used to receive plug-and-play event notification. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_QUERY_TARGET_PNP_HANDLE-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_QUERY_TARGET_PNP_HANDLE constant.

ReceiveAll 2550136833

Aktiviert das Empfangen aller IPv4-Pakete im Netzwerk.Enable receiving all IPv4 packets on the network. Der Socket muss über die Adressfamilie InterNetwork verfügen, der Sockettyp muss Raw und der Protokolltyp IP sein.The socket must have address family InterNetwork, the socket type must be Raw, and the protocol type must be IP. Der aktuelle Benutzer muss der Gruppe Administratoren auf dem lokalen Computer angehören, und der Socket muss an einen bestimmten Anschluss gebunden sein.The current user must belong to the Administrators group on the local computer, and the socket must be bound to a specific port. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_RCVALL-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_RCVALL constant.

ReceiveAllIgmpMulticast 2550136835

Aktiviert das Empfangen aller IGMP (Internet Group Management Protocol)-Pakete im Netzwerk.Enable receiving all Internet Group Management Protocol (IGMP) packets on the network. Der Socket muss über die Adressfamilie InterNetwork verfügen, der Sockettyp muss Raw und der Protokolltyp Igmp sein.The socket must have address family InterNetwork, the socket type must be Raw, and the protocol type must be Igmp. Der aktuelle Benutzer muss der Gruppe Administratoren auf dem lokalen Computer angehören, und der Socket muss an einen bestimmten Anschluss gebunden sein.The current user must belong to the Administrators group on the local computer, and the socket must be bound to a specific port. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_RCVALL_IGMPMCAST-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_RCVALL_IGMPMCAST constant.

ReceiveAllMulticast 2550136834

Aktiviert das Empfangen aller IPv4-Multicastpakete im Netzwerk.Enable receiving all multicast IPv4 packets on the network. Dies sind Pakete mit Zieladressen im Bereich 224.0.0.0 bis 239.255.255.255.These are packets with destination addresses in the range 224.0.0.0 through 239.255.255.255. Der Socket muss über die Adressfamilie InterNetwork verfügen, der Sockettyp muss Raw und der Protokolltyp Udp sein.The socket must have address family InterNetwork, the socket type must be Raw, and the protocol type must be Udp. Der aktuelle Benutzer muss der Gruppe Administratoren auf dem lokalen Computer angehören, und der Socket muss an einen bestimmten Anschluss gebunden sein.The current user must belong to the Administrators group on the local computer, and the socket must be bound to a specific port. Dieser Steuerungscode wird von Windows 2000 und höher unterstützt.This control code is supported on Windows 2000 and later operating systems. Dieser Wert entspricht der SIO_RCVALL_MCAST-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_RCVALL_MCAST constant.

RoutingInterfaceChange 2281701397

Aktiviert das Empfangen einer Benachrichtigung, wenn sich die für den Zugriff auf einen Remoteendpunkt verwendete lokale Schnittstelle ändert.Enable receiving notification when the local interface used to access a remote endpoint changes. Dieser Wert entspricht der SIO_ROUTING_INTERFACE_CHANGE-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_ROUTING_INTERFACE_CHANGE constant.

RoutingInterfaceQuery 3355443220

Gibt die Schnittstellenadressen zurück, die zum Herstellen einer Verbindung mit der angegebenen Remoteadresse verwendet werden können.Return the interface addresses that can be used to connect to the specified remote address. Dieser Wert entspricht der SIO_ROUTING_INTERFACE_QUERY-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_ROUTING_INTERFACE_QUERY constant.

SetGroupQos 2281701388

Legt die QOS (Quality of Service)-Attribute für die Socketgruppe fest.Set the Quality of Service (QOS) attributes for the socket group. Dieser Wert ist für eine zukünftige Verwendung reserviert und entspricht der SIO_SET_GROUP_QOS-Konstante von Winsock 2.This value is reserved for future use and is equal to the Winsock 2 SIO_SET_GROUP_QOS constant.

SetQos 2281701387

Legt die QOS (Quality of Service)-Attribute für den Socket fest.Set the Quality of Service (QOS) attributes for the socket. Mit QOS werden die Bandbreitenanforderungen für den Socket definiert.QOS defines the bandwidth requirements for the socket. Dieser Steuerungscode wird von Windows Me, Windows 2000 und höher unterstützt.This control code is supported on Windows Me, Windows 2000, and later operating systems. Dieser Wert entspricht der SIO_SET_QOS-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_SET_QOS constant.

TranslateHandle 3355443213

Gibt ein Handle für den Socket zurück, das im Kontext einer Begleitschnittstelle gültig ist.Return a handle for the socket that is valid in the context of a companion interface. Dieser Wert entspricht der SIO_TRANSLATE_HANDLE-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_TRANSLATE_HANDLE constant.

UnicastInterface 2550136838

Legt die Schnittstelle für ausgehende Unicastpakete fest.Set the interface used for outgoing unicast packets. Dieser Wert entspricht der SIO_UCAST_IF-Konstante von Winsock 2.This value is equal to the Winsock 2 SIO_UCAST_IF constant.

Beispiele

Im folgenden Codebeispiel wird die IOControl(IOControlCode, Byte[], Byte[]) -Methode mit einem DataToRead-Parameterwert aufgerufen und das Ergebnis mit dem Zugriff auf das verglichen.AvailableThe following code example calls the IOControl(IOControlCode, Byte[], Byte[]) method with a DataToRead parameter value and compares the result with accessing the.Available -Eigenschaft veranschaulicht.property.

void DisplayPendingByteCount( Socket^ s )
{
   array<Byte>^ outValue = BitConverter::GetBytes( 0 );
   
   // Check how many bytes have been received.
   s->IOControl( IOControlCode::DataToRead, nullptr, outValue );

   UInt32 bytesAvailable = BitConverter::ToUInt32( outValue, 0 );
   Console::Write( "server has {0} bytes pending,",
      bytesAvailable );
   Console::WriteLine( "Available property says {1}.",
      s->Available );
   return;
}
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 Socket-Betriebsmodi bereit.The IOControlCode enumeration provides named values for specifying socket operational modes. Diese Werte sind die Steuerungs Codes, die an die Funktion Windows Sockets 2 (Winsock WSAIoctl 2) übermittelt werden.These values are the control codes passed to the Windows Sockets 2 (Winsock 2) WSAIoctl function.

Gilt für: