Класс CAsyncSocket

Статья
06/10/2015

Представляет сокет Windows — конечную точку связи системы.

class CAsyncSocket : public CObject

Члены

Открытые конструкторы

Имя	Описание
CAsyncSocket::CAsyncSocket	Создает объект CAsyncSocket.

Открытые методы

Имя	Описание
CAsyncSocket::Accept	Принимает соединения для сокета.
CAsyncSocket::AsyncSelect	Запрашивает уведомление о событии для сокета.
CAsyncSocket::Attach	Вложение дескриптор сокета к объекту CAsyncSocket.
CAsyncSocket::Bind	Связывает локальный адрес с гнездом.
CAsyncSocket::Close	Закрывает сокета.
CAsyncSocket::Connect	Устанавливает соединение с гнезду однорангового узла.
CAsyncSocket::Create	Создает сокет.
CAsyncSocket::Detach	Наконец удаляет дескриптор сокета из объекта CAsyncSocket.
CAsyncSocket::FromHandle	Возвращает указатель на объект CAsyncSocket заданный дескриптор сокета.
CAsyncSocket::GetLastError	Возвращает состояние ошибки для последней выполненной операции, которая завершилась ошибкой.
CAsyncSocket::GetPeerName	Возвращает адрес сокета однорангового узла, для которого сокет подключено.
CAsyncSocket::GetPeerNameEx	Возвращает адрес сокета однорангового узла, для которого сокет подключено (адреса IP версии 6 дескрипторов).
CAsyncSocket::GetSockName	Возвращает локальное имя для сокета.
CAsyncSocket::GetSockNameEx	Возвращает локальное имя для сокета (адреса IP версии 6 дескрипторов).
CAsyncSocket::GetSockOpt	Извлекает параметр сокета.
CAsyncSocket::IOCtl	Контролирует режим сокета.
CAsyncSocket::Listen	Задает сокет для ожидания запросов входящего подключения.
CAsyncSocket::Receive	Возвращает данные из сокета.
CAsyncSocket::ReceiveFrom	Принимает датаграмму и хранит адрес источника.
CAsyncSocket::ReceiveFromEx	Принимает датаграмму и хранит адрес источника (адреса IP версии 6 дескрипторов).
CAsyncSocket::Send	Отправляет данные к подключенному гнезду.
CAsyncSocket::SendTo	Отправляет данные к определенной цели.
CAsyncSocket::SendToEx	Отправляет данные на определенный назначения (адреса IP версии 6 дескрипторов).
CAsyncSocket::SetSockOpt	Устанавливает параметр сокета.
CAsyncSocket::ShutDown	Запрещает Отправить и вызовы Получить для сокета.
CASyncSocket::Socket	Выделяет дескриптор сокета.

Защищенные методы

Имя	Описание
CAsyncSocket::OnAccept	Уведомляет прослушивания сокета, что он может принятия ожидающих запросов на подключение, вызвав Принять.
CAsyncSocket::OnClose	Уведомляет сокет, что сокет, подключенное к нему закрыло.
CAsyncSocket::OnConnect	Уведомляет при подключении сокет, что попытка соединения ли успешно завершена или в ошибке.
CAsyncSocket::OnOutOfBandData	Уведомляет при получении сокет, что экстренные данные для чтения на сокете, обычно срочное сообщение.
CAsyncSocket::OnReceive	Сообщает, что данные прослушивания сокета, который будет извлекать путем вызова Получить.
CAsyncSocket::OnSend	Уведомляет сокет, что он может отправлять данные путем вызова Отправить.

Открытые операторы

Имя	Описание
CAsyncSocket::operator =	Присвоить новое значение объекта CAsyncSocket.
СОКЕТ CAsyncSocket::operator	Этот оператор используется для получения дескриптора SOCKET объекта CAsyncSocket.

Открытые члены данных

Имя	Описание
CAsyncSocket::m_hSocket	Указывает вложенный дескриптор SOCKET к данному объекту CAsyncSocket.

Заметки

Класс CAsyncSocket инкапсулирует функции Windows API сокета, предоставляя объект- ориентированную абстракцию для программистов, которые хотят использовать Windows sockets совместно с MFC.

Этот класс основан на предположении, что пользователь понимает связи системы. Ответственность за отключить обработку, разнец в порядка байтов и преобразований между Юникодом и строками многобайтовой кодировки (mbcs). Если требуется более удобный интерфейс, который управляет эти проблемы, см. класс CSocket.

Использование объекта CAsyncSocket, вызывая его конструктор затем для вызова функции Создание чтобы создать основной дескриптор сокета (тип SOCKET), за исключением на несколько допустимых сокетов. Для вызова функции-члена ожидать передачи данных сокета сервера и клиента Соединение сокета для вызова функции-члена. Сокет сервера должно вызвать функцию Принять вариант при получении запроса соединения. Используйте остальные функции CAsyncSocket для выполнения сообщения между гнездами. По завершении уничтожить объект CAsyncSocket если он был создан на куче. деструктор автоматически вызывает функцию Закрыть. Тип данных SOCKET описана в статье Windows sockets: фон.

Примечание

При использовании сокетов MFC в статической вторичных потоков в связанном приложении MFC, необходимо вызвать AfxSocketInit в каждом потоке, который использует сокета для инициализации библиотеки сокета.По умолчанию AfxSocketInit вызываются только в основном потоке.

Дополнительные сведения см. в разделе Windows sockets: Использование класса CAsyncSocket и относящиеся к ним статьи., а также API Windows sockets 2.