Socket.DisconnectAsync(SocketAsyncEventArgs) Methode

Definition

Beginnt eine asynchrone Anforderung zum Trennen der Verbindung mit einem Remoteendunkt.Begins an asynchronous request to disconnect from a remote endpoint.

public:
 bool DisconnectAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);
public bool DisconnectAsync (System.Net.Sockets.SocketAsyncEventArgs e);
member this.DisconnectAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool
Public Function DisconnectAsync (e As SocketAsyncEventArgs) As Boolean

Parameter

e
SocketAsyncEventArgs

Das SocketAsyncEventArgs-Objekt, das für diesen asynchronen Socketvorgang verwendet werden soll.The SocketAsyncEventArgs object to use for this asynchronous socket operation.

Gibt zurück

true, wenn der E/A-Vorgang aussteht.true if the I/O operation is pending. Das Completed-Ereignis für den e-Parameter wird nach dem Abschluss des Vorgangs ausgelöst.The Completed event on the e parameter will be raised upon completion of the operation.

false, wenn der E/A-Vorgang synchron abgeschlossen wurde.false if the I/O operation completed synchronously. In diesem Fall wird das Completed-Ereignis für den e-Parameter nicht ausgelöst, und das als Parameter übergebene e-Objekt kann direkt nach der Rückgabe des Methodenaufrufs untersucht werden, um die Ergebnisse des Vorgangs abzurufen.In this case, The Completed event on the e parameter will not be raised and the e object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation.

Ausnahmen

Der e-Parameter darf nicht NULL sein.The e parameter cannot be null.

Es wird bereits ein Socketvorgang mit dem im e-Parameter angegebenen SocketAsyncEventArgs-Objekt ausgeführt.A socket operation was already in progress using the SocketAsyncEventArgs object specified in the e parameter.

Für diese Methode ist Windows XP oder höher erforderlich.Windows XP or later is required for this method.

Der Socket wurde geschlossen.The Socket has been closed.

Fehler beim Versuch, auf den Socket zuzugreifen.An error occurred when attempting to access the socket.

Hinweise

Wenn Sie ein Verbindungs orientiertes Protokoll verwenden, wird beim Aufrufen der DisconnectAsync-Methode die Verbindung von einem Remote Endpunkt getrennt.When using a connection-oriented protocol, calling the DisconnectAsync method requests a disconnect from a remote endpoint. Wenn Sie SocketAsyncEventArgs.DisconnectReuseSocket auf true im e-Parameter festlegen, kann der Socket wieder verwendet werden.If you set SocketAsyncEventArgs.DisconnectReuseSocket to true in the e parameter, the socket can be reused.

Gilt für:

Siehe auch