Classe de CAsyncSocket

Article
03/26/2013

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.

[!REMARQUE]

À 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.