Partager via


CAsyncSocket, classe

Représente un Winsock — un point de terminaison de communication réseau.

class CAsyncSocket : public CObject

Membres

Constructeurs publics

Nom

Description

CAsyncSocket::CAsyncSocket

Construit un objet CAsyncSocket.

Méthodes publiques

Nom

Description

CAsyncSocket::Accept

Accepte une connexion du socket.

CAsyncSocket::AsyncSelect

Demande la notification d'événements du socket.

CAsyncSocket::Attach

Joint un handle de socket à un objet d' CAsyncSocket .

CAsyncSocket::Bind

Associe une adresse locale du socket.

CAsyncSocket::Close

Ferme le socket.

CAsyncSocket::Connect

Établit une connexion à un socket homologue.

CAsyncSocket::Create

Crée un socket.

CAsyncSocket::Detach

Détache un handle de socket d'un objet d' CAsyncSocket .

CAsyncSocket::FromHandle

Retourne un pointeur vers un objet d' CAsyncSocket , étant donné un handle de socket.

CAsyncSocket::GetLastError

Obtient l'état d'erreur pour la dernière opération qui a échoué.

CAsyncSocket::GetPeerName

Obtient l'adresse du socket homologue auquel le socket est connecté.

CAsyncSocket::GetPeerNameEx

Obtient l'adresse du socket homologue auquel le socket est connecté (les adresses de IPv6 de handles).

CAsyncSocket::GetSockName

Obtient le nom local pour un socket.

CAsyncSocket::GetSockNameEx

Obtient le nom local pour un socket (adresses de IPv6 de handles).

CAsyncSocket::GetSockOpt

Extrait une option de socket.

CAsyncSocket::IOCtl

Contrôle le mode de socket.

CAsyncSocket::Listen

Génère un socket pour écouter les demandes de connexion entrante.

CAsyncSocket::Receive

Reçoit les données du socket.

CAsyncSocket::ReceiveFrom

Accepte un datagramme et stocke l'adresse source.

CAsyncSocket::ReceiveFromEx

Accepte un datagramme et stocke l'adresse source (adresses de IPv6 de handles).

CAsyncSocket::Send

Envoie des données à un socket connecté.

CAsyncSocket::SendTo

Envoie des données à une destination spécifique.

CAsyncSocket::SendToEx

Envoie des données à une destination spécifique (adresses de IPv6 de handles).

CAsyncSocket::SetSockOpt

Définit une option de socket.

CAsyncSocket::ShutDown

Désactive Envoyer et/ou appel de Recevoir de socket.

CASyncSocket::Socket

Alloue un handle de socket.

Méthodes protégées

Nom

Description

CAsyncSocket::OnAccept

Avertit un socket écoutant qu'elle peut recevoir en attente des demandes de connexion en appelant Accepter.

CAsyncSocket::OnClose

Avertit un socket que le socket connecté à ce dernier est fermé.

CAsyncSocket::OnConnect

Avertit un socket la connexion que la tentative de connexion est terminée, si avec succès ou dans l'erreur.

CAsyncSocket::OnOutOfBandData

Avertit un socket de réception qu'il existe des données hors bande à lire du socket, généralement un message urgent.

CAsyncSocket::OnReceive

Avertit un socket écoutant qu'il existe des données à récupérer en appelant Recevoir.

CAsyncSocket::OnSend

Avertit un socket qu'il peut envoyer des données en appelant Envoyer.

Opérateurs publics

Nom

Description

CAsyncSocket::operator =

Assigne une valeur à un objet d' CAsyncSocket .

SOCKET de CAsyncSocket::operator

Utilisez cet opérateur pour récupérer le handle de tête creuse de l'objet d' CAsyncSocket .

Données membres publiques

Nom

Description

CAsyncSocket::m_hSocket

Indique le handle de tête creuse associé à cet objet d' CAsyncSocket .

Notes

La classe CAsyncSocket encapsule l'API de fonctions Winsock, en fournissant une abstraction orientée objet pour les programmeurs qui souhaitent utiliser Windows Sockets avec MFC.

Cette classe est basé sur l'hypothèse que vous comprenez les communications réseau. Vous êtes chargé de bloquer de gérer, de différences de marque d'ordre d'octet, et de conversions entre Unicode et les chaînes du jeu de caractères multioctets (MBCS). Si vous souhaitez une interface plus pratique qui gère ces problèmes pour vous, consultez la classe CSocket.

Pour utiliser un objet d' CAsyncSocket , appelez son constructeur, puis appelez la fonction de création pour créer le handle sous-jacent de socket (type SOCKET), sauf sur les sockets acceptés. Pour un socket de serveur appelez la fonction membre d' écoutez , et un socket client appelez la fonction membre de connectez . Le socket de serveur doit appeler la fonction d' Acceptez à accepter une demande de connexion. Utilisez les fonctions restantes d' CAsyncSocket pour effectuer des communications entre les sockets. Une fois l'opération terminée, détruisez l'objet d' CAsyncSocket s'il a été créé sur le tas ; le destructeur appelle automatiquement la fonction de Fermez . Le type de données d' SOCKET est décrite dans l'article Windows Sockets : Arrière-plan.

Notes

À l'aide de sockets MFC dans les threads secondaires dans une application liée statiquement MFC, vous devez appeler AfxSocketInit dans chaque thread qui utilise des sockets pour initialiser les bibliothèques de socket.Par défaut, AfxSocketInit est appelé uniquement dans le thread principal.

Pour plus d'informations, consultez Windows Sockets : À l'aide de la classe CAsyncSocket et les éléments connexes., ainsi que l' API Windows Sockets 2.

Hiérarchie d'héritage

CObject

CAsyncSocket

Configuration requise

en-tête : afxsock.h

Voir aussi

Référence

CObject, classe

Graphique de la hiérarchie

CSocket, classe

CSocketFile, classe