接続を受け入れます、 ソケットは、最初に socket 関数で作成されて、bind 関数でローカルアドレスに密接に結びつきます、 入ってくる接続用の backlog はlisten と共に指定されます、 そして、それから、接続は accept 関数で受け入れられます。 接続志向であるソケット、 たとえばタイプ SOCK_STREAM のそれら、 listen と共に使用されます。 ソケット s は、入ってくる接続要求が認められて、プロセスによって待ち行列に受け入れられると、 パッシブモードとして置かれます。

listen 関数は、同時に複数の接続要求を出来るサーバにより典型的に用いられます。 もし接続要求が届き、そして、キューが一杯であるならば、 クライアントは WSAECONNREFUSED の指示と共にエラーを受け取るでしょう。

もしソケット記述子が利用可能ではないならば、listen は、関数を続けようとします。 もし記述子が利用可能になるならば、 listen または accept への呼出し後は、 カレント または ごく最近の backlog にキューを補充するでしょう、 もし出来れば、そして、入ってくる接続のために聞き耳を立てる事を再開します。

もし listen が既に聞き取り中であるソケット上において呼ばれるならば、 それは、backlog 変更とは別に成功を戻すでしょう。 聞き取り中ソケット上において、次の listen 呼び出し内にて backlog を 0 にセッティングする事は、 作法通りのリセットであるとは良く考えられません、 特にもしソケットに接続があるならば。

/*
 * file:winsock2listen_example1.c
 * The listen function places a socket in a state in which it is listening for an incoming connection.
 * 参照 http://msdn2.microsoft.com/en-us/library/ms739168.aspx
 */
#include <stdio.h>
#include "winsock2.h"

int main()
{
    /*
     * 変数の宣言。
     */
    WSADATA wsaData;
    int iResult = 0;
    SOCKET ListenSocket;
    struct sockaddr_in service;

    /*
     * Winsockの初期化。
     */
    iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != NO_ERROR)
    {
        printf("Error at WSAStartup()\n");
        return 0;
    }

    /*
     * 接続要求受入用のリスニング用のソケットを作成。
     */
    ListenSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ListenSocket == INVALID_SOCKET)
    {
        printf("Error at socket(): %ld\n", WSAGetLastError());
        WSACleanup();
        return 0;
    }

    /*
     * そのsockaddr_in構造体はそのアドレスファミリィを指定する、
     * IPアドレス、そして、結びつけられているソケットのためのポート。
     */
    service.sin_family = AF_INET;
    service.sin_addr.s_addr = inet_addr("127.0.0.1");
    service.sin_port = htons(27015);

    /*
     * ソケットをバインドする。
     */
    if (bind(ListenSocket, (SOCKADDR*)&service, sizeof(service))
            == SOCKET_ERROR)
    {
        printf("bind() failed.\n");
        closesocket(ListenSocket);
        WSACleanup();
        return 0;
    }

    /*
     * 作成されたソケット上にて、
     * 接続要求受け入れ用のリッスンをします。
     */
    if (listen(ListenSocket, 1) == SOCKET_ERROR)
    {
        printf("Error listening on socket.\n");
    }

    printf("Listening on socket...\n");
    WSACleanup();
    return 0;
}

• Af_irda.h ヘッダファイルは明示的にインクルードされなければなりません。