Clase de CAsyncSocket

Artículo
04/10/2013

Representa un socket de Windows — un extremo de comunicación por red.

class CAsyncSocket : public CObject

Members

Constructores públicos

Name	Descripción
CAsyncSocket::CAsyncSocket	Crea un objeto CAsyncSocket.

Métodos públicos

Name	Descripción
CAsyncSocket::Accept	acepta una conexión en el socket.
CAsyncSocket::AsyncSelect	solicita la notificación de eventos para el socket.
CAsyncSocket::Attach	Asocia un identificador de socket a un objeto de CAsyncSocket .
CAsyncSocket::Bind	Asocia una dirección local al socket.
CAsyncSocket::Close	Cierre el socket.
CAsyncSocket::Connect	Establece una conexión a un socket del mismo nivel.
CAsyncSocket::Create	crea un socket.
CAsyncSocket::Detach	Desasocia un identificador de socket de un objeto de CAsyncSocket .
CAsyncSocket::FromHandle	Devuelve un puntero a un objeto de CAsyncSocket , dado un identificador de socket.
CAsyncSocket::GetLastError	Obtiene el estado de error de la última operación que produjo un error.
CAsyncSocket::GetPeerName	Obtiene la dirección del socket del mismo nivel con el que el socket está conectado.
CAsyncSocket::GetPeerNameEx	Obtiene la dirección del socket del mismo nivel con el que el socket está conectado (las direcciones de IPv6 de identificadores).
CAsyncSocket::GetSockName	obtiene el nombre local para un socket.
CAsyncSocket::GetSockNameEx	Obtiene el nombre local para un socket (direcciones de IPv6 de identificadores).
CAsyncSocket::GetSockOpt	Recupera una opción de socket.
CAsyncSocket::IOCtl	Controla el modo de socket.
CAsyncSocket::Listen	Establece un socket para realizar escuchas para las solicitudes de conexión entrante.
CAsyncSocket::Receive	Recibe datos de socket.
CAsyncSocket::ReceiveFrom	Recibe un datagrama y almacena la dirección de origen.
CAsyncSocket::ReceiveFromEx	Recibe un datagrama y almacena la dirección de origen (direcciones de IPv6 de identificadores).
CAsyncSocket::Send	Envía los datos a un socket conectado.
CAsyncSocket::SendTo	Envía los datos a un destino concreto.
CAsyncSocket::SendToEx	Envía los datos a un destino concreto (direcciones de IPv6 de identificadores).
CAsyncSocket::SetSockOpt	Establece una opción de socket.
CAsyncSocket::ShutDown	deshabilita las llamadas de Enviar y/o de Recibir en el socket.
CASyncSocket::Socket	Asigna un identificador de socket.

Métodos protegidos

Name	Descripción
CAsyncSocket::OnAccept	Notifica un socket que escucha que acepte pendientes solicitudes de conexión llamando a acepte.
CAsyncSocket::OnClose	Notifica un socket que se ha cerrado el socket conectado a él.
CAsyncSocket::OnConnect	Notifica un socket de conexión que el intento de conexión está completo, si correctamente o de error.
CAsyncSocket::OnOutOfBandData	Notifica un socket que recibe que hay datos fuera de banda que se leerán del socket, normalmente un mensaje urgente.
CAsyncSocket::OnReceive	Notifica un socket que escucha que hay datos que se recuperarán llamando a Recibir.
CAsyncSocket::OnSend	Notifica un socket que puede enviar datos llamando a Enviar.

Operadores públicos

Name	Descripción
CAsyncSocket::operator =	asigna un nuevo valor a un objeto de CAsyncSocket .
SOCKET de CAsyncSocket::operator	Este operador se utiliza para recuperar el identificador de SOCKET del objeto de CAsyncSocket .

Miembros de datos públicos

Name	Descripción
CAsyncSocket::m_hSocket	Indica el identificador de SOCKET asociado a este objeto de CAsyncSocket .

Comentarios

La clase CAsyncSocket encapsula las funciones API de socket de Windows, proporcionando una abstracción orientado para programadores que desean utilizar el Windows Sockets junto con MFC.

Esta clase se basa en la suposición de que entiende comunicaciones por red.Es responsable de administrar el bloqueo, diferencias de orden de bytes, y conversiones entre Unicode y cadenas de juego de caracteres multibyte (MBCS).Si desea una interfaz más conveniente administrar estos problemas para usted, vea la clase CSocket.

Para utilizar un objeto de CAsyncSocket , llamar a su constructor, entonces para llamar a la función de Crear para crear el identificador subyacente de socket (tipo SOCKET), excepto en sockets aceptados.Para una llamada de socket de servidor la función miembro de Escucha , y para una llamada de socket de cliente la función miembro de Conectar .El socket de servidor debe llamar a la función de acepte al recibir una solicitud de conexión.Utilice las funciones restantes de CAsyncSocket para realizar comunicaciones entre sockets.Al finalizar, destruya el objeto de CAsyncSocket si se ha creado en la pila; destructor llama automáticamente a la función de Cerrar .Describe el tipo de datos de SOCKET en el caso Windows Sockets: Fondo.

[!NOTA]

Al utilizar los MFC sockets en subprocesos secundarios en una aplicación MFC vinculada estáticamente, debe llamar a AfxSocketInit en cada subproceso que utilice sockets para inicializar las bibliotecas de socket.De forma predeterminada, AfxSocketInit sólo se llama en el subproceso primario.

Para obtener más información, vea Windows Sockets: Mediante la clase CAsyncSocket y artículos relacionados., así como Windows Sockets 2 API.