Classe CAsyncSocket

Articolo
06/10/2015

Rappresenta un socket di Windows a un endpoint di comunicazione di rete.

class CAsyncSocket : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CAsyncSocket::CAsyncSocket	Costruisce un oggetto CAsyncSocket.

Metodi pubblici

Nome	Descrizione
CAsyncSocket::Accept	Accetta una connessione su socket.
CAsyncSocket::AsyncSelect	Richiede la notifica degli eventi per il socket.
CAsyncSocket::Attach	Associa un handle di socket a un oggetto CAsyncSocket.
CAsyncSocket::Bind	Associa un indirizzo locale con un socket.
CAsyncSocket::Close	Consente di socket.
CAsyncSocket::Connect	Stabilisce una connessione a un socket peer.
CAsyncSocket::Create	Crea un socket.
CAsyncSocket::Detach	Rimuove un handle di socket da un oggetto CAsyncSocket.
CAsyncSocket::FromHandle	Restituisce un puntatore a un oggetto CAsyncSocket, dato un handle di socket.
CAsyncSocket::GetLastError	Ottiene lo stato di errore per l'ultima operazione non riuscito.
CAsyncSocket::GetPeerName	Ottiene l'indirizzo di socket peer in cui un socket è connesso.
CAsyncSocket::GetPeerNameEx	Ottiene l'indirizzo di socket peer in cui un socket è connesso (indirizzi IPv6 di handle).
CAsyncSocket::GetSockName	Ottiene il nome locale per un socket.
CAsyncSocket::GetSockNameEx	Ottiene il nome locale per un socket (indirizzi IPv6 di handle).
CAsyncSocket::GetSockOpt	Recupera un'opzione di socket.
CAsyncSocket::IOCtl	Controlla la modalità di socket.
CAsyncSocket::Listen	Stabilisce un socket per ascoltare le richieste di connessione in ingresso.
CAsyncSocket::Receive	Riceve dati da socket.
CAsyncSocket::ReceiveFrom	Riceve un datagram e archivia l'indirizzo di destinazione.
CAsyncSocket::ReceiveFromEx	Riceve un datagram e archivia l'indirizzo di destinazione (indirizzi IPv6 di handle).
CAsyncSocket::Send	Invia i dati a un socket collegato.
CAsyncSocket::SendTo	Invia i dati a una destinazione specifica.
CAsyncSocket::SendToEx	Invia i dati a una destinazione specifica (indirizzi IPv6 di handle).
CAsyncSocket::SetSockOpt	Imposta un'opzione di socket.
CAsyncSocket::ShutDown	Disabilita Invia e/o le chiamate Ricezione su socket.
CASyncSocket::Socket	Alloca un handle di socket.

Metodi protetti

Nome	Descrizione
CAsyncSocket::OnAccept	Notifica un socket in ascolto che può accettare in attesa di richieste di connessione chiamando Accept.
CAsyncSocket::OnClose	Notifica un socket che il socket connessi a chiuso.
CAsyncSocket::OnConnect	Notifica un connettore che il tentativo di connessione è completo, se correttamente o per errore.
CAsyncSocket::OnOutOfBandData	Notifica un socket di ricezione che sono presenti dati fuori banda da leggere su socket, in genere un messaggio urgente.
CAsyncSocket::OnReceive	Notifica un socket in ascolto che vi sono dati da recuperare Ricezionechiamando.
CAsyncSocket::OnSend	Notifica un socket che può inviare dati chiamando Invia.

Operatori pubblici

Nome	Descrizione
CAsyncSocket::operator =	Assegna un valore a un oggetto CAsyncSocket.
SOCKET di CAsyncSocket::operator	Consente di recuperare l'handle SOCKET dell'oggetto CAsyncSocket.

Membri dati pubblici

Nome	Descrizione
CAsyncSocket::m_hSocket	Indica un handle SOCKET associato a questo oggetto CAsyncSocket.

Note

La classe CAsyncSocket incapsula le funzioni API di socket di Windows, fornendo un'astrazione orientata a oggetti per i programmatori che desiderano utilizzare Windows Sockets insieme con MFC.

Questa classe è basata su presupposti comprendere le comunicazioni di rete. È responsabile della gestione del blocco, le differenze di ordine dei byte e le conversioni tra Unicode e stringhe con i set di caratteri multibyte (MBCS). Se si desidera un'interfaccia più pratico che gestisce questi problemi di, vedere la classe CSocket.

Per utilizzare un oggetto CAsyncSocket, chiamare il costruttore, quindi chiamare la funzione Crea per creare un handle sottostante di socket (tipo SOCKET), tranne nei socket accettati. Per un socket del server chiamare la funzione membro È in ascolto e un socket client richiedono la funzione membro Connetti. Socket il server deve chiamare la funzione Accettare a ricevere una richiesta di connessione. Utilizzare le funzioni rimanenti CAsyncSocket per gestire le comunicazioni tra i socket. Al completamento, eliminare l'oggetto CAsyncSocket se è stato creato nell'heap; il distruttore chiama automaticamente la funzione Chiudi. Il tipo di dati SOCKET è descritto nell'articolo Windows Sockets: sfondo.

Nota

In utilizzare sockets MFC nei thread secondari in un'applicazione collegata in modo statico MFC, è necessario chiamare AfxSocketInit in ogni thread che utilizza i socket per inizializzare le librerie di socket.Per impostazione predefinita, AfxSocketInit viene chiamato solo nel thread primario.

Per ulteriori informazioni, vedere Windows Sockets: Utilizzo di classe CAsyncSocket e gli articoli correlati. nonché Windows Sockets 2 API.