CAsyncSocket::Create

BOOL Create ( UINT nSocketPort = 0, int nSocketType = SOCK_STREAM, длинные Левента = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE, LPCTSTR lpszSocketAddress = Значение NULL );

Возвращаемое значение

Ненулевое значение, если функция выполнена успешно; в противном случае 0 и код ошибки можно получить, вызвав функцию GetLastError. Следующие ошибки применяются к этой функции-члена:

• WSA&NOTINITIALISEDnbsp;  Перед использованием этого API должно произойти успешный AfxSocketInit.
  
  
• WSAE&NETDOWNnbsp;  Реализация Windows Sockets обнаружено, что сетевая подсистема не.
  
  
• WSAEAF&NOSUPPORTnbsp;  Заданного семейства адресов не поддерживается.
  
  
• WSAEI&NPROGRESSnbsp;  Блокировки Windows Sockets операция.
  
  
• WSAEMFILE   Не более файловые дескрипторы доступны.
  
  
• WSAE&NOBUFSnbsp;  Буферное пространство доступен. Объект socket не может быть создан.
  
  
• WSAEPROTO&NOSUPPORTnbsp;  Указанный порт не поддерживается.
  
  
• WSAEPROTOTYPE   Указанный порт имеет неправильный тип для этого сокета.
  
  
• WSAESOCKT&NOSUPPORTnbsp;  Указанный тип сокета не поддерживается в данном семействе адресов.

Параметры

nSocketPort

Известный порт для использования с socket, или 0, если требуется Windows Sockets для выбора порта.

nSocketType

SOCK_STREAM или SOCK_DGRAM.

левент

Битовая маска, которая определяет комбинацию сетевых событий, в которых заинтересовано приложение.

• FD_READ   Хотите получать уведомления о готовности для чтения.
  
  
• FD_WRITE   Хотите получать уведомления о готовности для записи.
  
  
• FD_OOB   Хотите получать уведомления о прибытии-диапазона данных.
  
  
• FD_ACCEPT   Хотите получать уведомления о входящих подключений.
  
  
• FD_CO&NNECTnbsp;  Хотите получать уведомления о завершенных подключения.
  
  
• FD_CLOSE   Хотите получать уведомления о закрытии сокета.

lpszSockAddress

Указатель на строку, содержащую сетевой адрес подключенного сокета, пунктирным число таких, как «128.56.22.8».

Примечания

Вызовите функцию-член Create после построения объекта socket для создания сокета Windows и прикрепить ее. Создание вызывает привязку к связать сокет по указанному адресу. Поддерживаются следующие типы сокетов:

• SOCK_STREAM   Обеспечивает последовательный, надежный, полный дуплекс подключения-байтовые потоки. Использует протокол управления передачей (TCP) для семейства адресов Интернет.
  
  
• SOCK_DGRAM   Поддерживает датаграмм, которые являются без установления соединения, ненадежные пакеты фиксированной (обычно маленькая) максимальной длины. Использует протокол датаграмм пользователя (UDP) для семейства адресов Интернет.

  Примечание   Функция-член Accept принимает ссылку на новый, пустой объект CSocket в качестве параметра. Этот объект необходимо создать перед вызовом метода Accept. Имейте в виду, что если этот объект socket выходит из области действия, подключение закрывается. Не следует вызывать создать для этого нового объекта socket.

Для получения дополнительных сведений о потоке и датаграмм розетки, обратитесь к статьям Windows Sockets: фон и Windows Sockets: порты и адреса сокета в Руководстве по Visual C++ программист и Обзор Windows Sockets 2 и Соображения программирования Windows Sockets в документации Win32 SDK.

Обзор CAsyncSocket |nbsp; Члены класса | Иерархическая схема

См. такжеnbsp;CAsyncSocket::Accept, CAsyncSocket::Bind, CAsyncSocket::Connect, CAsyncSocket::GetSock&Name,CAsyncSocket::IOCtl, CAsyncSocket::Listen, CAsyncSocket::Receive, CAsyncSocket::Send, CAsyncSocket::ShutDown