CAsyncSocket-Klasse

Artikel
06/10/2015

Stellt einen Windows Socket - einen Endpunkt der Netzwerkkommunikation dar.

class CAsyncSocket : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Description
CAsyncSocket::CAsyncSocket	Erstellt ein CAsyncSocket-Objekt.

Öffentliche Methoden

Name	Description
CAsyncSocket::Accept	Akzeptiert eine Verbindung auf dem Socket.
CAsyncSocket::AsyncSelect	Fordert Ereignisbenachrichtigung für den Socket.
CAsyncSocket::Attach	Fügt ein Sockethandle zu einem CAsyncSocket-Objekt.
CAsyncSocket::Bind	Ordnet eine lokale Adresse mit dem Socket zu.
CAsyncSocket::Close	Schließt den Socket.
CAsyncSocket::Connect	Richtet eine Verbindung zu einem Peersocket ein.
CAsyncSocket::Create	Erstellt einen Socket.
CAsyncSocket::Detach	Trennt ein Sockethandle von einem CAsyncSocket-Objekt.
CAsyncSocket::FromHandle	Gibt einen Zeiger auf ein Objekt zurück, CAsyncSocket ein Sockethandle zugewiesen.
CAsyncSocket::GetLastError	Ruft den Fehler-Status für den letzten Vorgang ab, der fehlgeschlagen ist.
CAsyncSocket::GetPeerName	Ruft die Adresse des Peersockets ab, an den der Socket verbunden ist.
CAsyncSocket::GetPeerNameEx	Ruft die Adresse des Peersockets ab, an den der Socket verbunden ist (Adressen der Handles IPv6).
CAsyncSocket::GetSockName	Ruft den lokalen Namen für einen Socket ab.
CAsyncSocket::GetSockNameEx	Ruft den lokalen Namen für einen Socket ab (Adressen der Handles IPv6).
CAsyncSocket::GetSockOpt	Ruft eine Socketoption ab.
CAsyncSocket::IOCtl	Steuert den Modus des Sockets.
CAsyncSocket::Listen	Richtet einen Socket ein, um auf eingehende Aufforderungen zum Aufbau einer Verbindung zu überwachen.
CAsyncSocket::Receive	Empfängt Daten vom Socket.
CAsyncSocket::ReceiveFrom	Empfängt ein Datagramm und speichert die Quelladresse.
CAsyncSocket::ReceiveFromEx	Empfängt ein Datagramm und speichert die Quelladresse (Adressen der Handles IPv6).
CAsyncSocket::Send	Sendet Daten zu verbundenen Socket.
CAsyncSocket::SendTo	Sendet Daten einem bestimmten Ziel.
CAsyncSocket::SendToEx	Sendet Daten einem bestimmten Ziel (Adressen der Handles IPv6).
CAsyncSocket::SetSockOpt	Legt eine Socketoption fest.
CAsyncSocket::ShutDown	Deaktiviert Send und/oder Receive Aufrufe an den Socket.
CASyncSocket::Socket	Ordnet ein Sockethandle zu.

Geschützte Methoden

Name	Description
CAsyncSocket::OnAccept	Benachrichtigt einen überwachenden Socket, dass er während Aufforderungen zum Aufbau einer Verbindung akzeptieren kann, indem er Annehmen aufruft.
CAsyncSocket::OnClose	Benachrichtigt einen Socket, dass der Socket, der mit ihm verbunden wird, geschlossen hat.
CAsyncSocket::OnConnect	Benachrichtigt eine Steckverbindung, dass der Verbindungsversuch abgeschlossen ist, ob erfolgreich oder im Fehler.
CAsyncSocket::OnOutOfBandData	Benachrichtigt einen empfangenden Socket, dass es auf die gibt dem Socket gelesen werden Out-of-Band-Daten, normalerweise eine dringende Meldung.
CAsyncSocket::OnReceive	Benachrichtigt einen überwachenden Socket, dass sie die mit gibt abgerufen werden Daten, Receive aufruft.
CAsyncSocket::OnSend	Benachrichtigt einen Socket, dass er Daten senden kann, indem er Send aufruft.

Öffentliche Operatoren

Name	Description
CAsyncSocket::operator =	Weist einen neuen Wert zu einem CAsyncSocket-Objekt zu.
CAsyncSocket::operator-SOCKET	Verwenden Sie diesen Operator, um das SOCKET Handle des CAsyncSocket-Objekts abzurufen.

Öffentliche Datenmember

Name	Description
CAsyncSocket::m_hSocket	Gibt das SOCKET Handle an, das diesem Objekt CAsyncSocket angefügt wird.

Hinweise

CAsyncSocket-Klasse kapselt die Windows Socket-Funktionen APIs und stellt eine objektorientierte Abstraktion für Programmierer bereit, die Windows Sockets in Verbindung mit MFC verwenden möchten.

Diese Klasse basiert auf der Annahme, dass Sie Netzwerkkommunikationen verstehen. Sie sind für das Behandelnblockieren, die Bytereihenfolgenunterschiede und die Konvertierungen zwischen Unicode und Zeichenfolgen mit Mehrbyte-Zeichensätzen (MBCS) zuständig. Wenn Sie eine zweckmäßigere Schnittstelle soll, die diese Probleme für Sie verwaltet werden, finden Sie unter CSocket-Klasse.

So fügen Sie ein Objekt CAsyncSocket verwenden, ihren Konstruktor aufrufen, die Erstellen Sie-Funktion aufzurufen, um das zugrunde liegende Sockethandle (Typ SOCKET), außer auf akzeptierte Sockets zu erstellen. Für einen Serversocket rufen Sie die Lauschen Sie-Memberfunktion auf, und für einen Clientsocket rufen Sie die Schließen Sie an-Memberfunktion auf. Der Serversocket sollte die Übernehmen Sie-Funktion nach Empfang einer Aufforderung zum Aufbau einer Verbindung aufrufen. Verwenden Sie die übrigen CAsyncSocket-Funktionen, um die Kommunikation zwischen Sockets durchzuführen. Nach Abschluss zerstören Sie das CAsyncSocket-Objekt, wenn es auf dem Heap erstellt wurde, der Destruktor wird automatisch die Schließen Sie-Funktion auf. Der SOCKET Datentyp wird im Artikel Windows Sockets: Hintergrund beschrieben.

Hinweis

Wenn Sie MFC-Sockets in den sekundären Threads in einer statisch verknüpften MFC-Anwendung verwenden, müssen Sie AfxSocketInit in jedem Thread aufrufen, der Sockets verwendet, um die Socketbibliotheken zu initialisieren.Standardmäßig wird AfxSocketInit nur im primären Thread aufgerufen.

Weitere Informationen finden Sie unter Windows Sockets: Verwenden der Klasse CAsyncSocket und verwandte Artikel. sowie Windows Sockets 2 API.