listen 関数 (winsock2.h)

listen 関数は、受信接続をリッスンしている状態でソケットを配置します。

構文

int WSAAPI listen(
  [in] SOCKET s,
  [in] int    backlog
);

パラメーター

[in] s

バインドされた接続されていないソケットを識別する記述子。

[in] backlog

保留中の接続のキューの最大長。 SOMAXCONN に設定すると、ソケット s を担当する基になるサービス プロバイダーによってバックログが最大妥当な値に設定されます。 SOMAXCONN_HINT(N) に設定すると (N は数値)、バックログ値は N になり、範囲内 (200、65535) 内に調整されます。 SOMAXCONN_HINTを使用して、SOMAXCONN で可能なよりも大きな値にバックログを設定できることに注意してください。

SOMAXCONN_HINT は、Microsoft TCP/IP サービス プロバイダーでのみサポートされています。 実際のバックログ値を取得するための標準のプロビジョニングはありません。

戻り値

エラーが発生しない場合、 listen は 0 を返します。 それ以外の場合は、 SOCKET_ERROR の値が返され、 WSAGetLastError を呼び出すことによって特定のエラー コードを取得できます。

注釈

接続を受け入れるために、ソケットはまず ソケット 関数を使用して作成され、バインド関数を使用してローカル アドレスに バインド されます。 受信接続のバックログは listen で指定され、その接続は accept 関数で 受け入れられます 。 接続指向のソケット (たとえば 、SOCK_STREAM 型のソケット) は、 リッスンと共に使用されます。 ソケット s はパッシブ モードになり、受信接続要求はプロセスによって受信確認され、キューに入れられます。

SOMAXCONN のバックログの値は、保留中の接続のキューの長さを最大の妥当な値に設定するように、ソケット s を担当する基になるサービス プロバイダーに指示する特別な定数です。

Windows ソケット 2 では、この最大値の既定値は大きい値 (通常は数百以上) です。

Bluetooth アプリケーションで listen 関数を呼び出す場合は、少数のクライアント接続しか受け入れられないため、 バックログ パラメーター (通常は 2 から 4) に使用することを強くお勧めします。 これにより、リッスン ソケットで使用するために割り当てられるシステム リソースが削減されます。 この同じ推奨事項は、少数のクライアント接続のみを想定する他のネットワーク アプリケーションにも適用されます。

リッスン関数は通常、一度に複数の接続要求を持つサーバーで使用されます。 接続要求が到着し、キューがいっぱいになると、クライアントは WSAECONNREFUSED を示すエラーを受け取ります。

使用可能なソケット記述子がない場合は、 リッスン によって引き続き機能が試行されます。 記述子が使用可能になった場合、 リッスン または 受け入れるため の後の呼び出しでは、 可能であれば、backlog パラメーターに指定された現在または最新の値にキューが補充され、受信接続のリッスンが再開されます。

既にリッスンしているソケットで listen 関数が呼び出されると、 backlog パラメーターの値を変更せずに成功を返します。 リッスンしているソケットでリッスンする後続の呼び出しで backlog パラメーターを 0 に設定しても、ソケットに接続がある場合は特に、適切なリセットとは見なされません。

コード例

#ifndef UNICODE
#define UNICODE
#endif

#define WIN32_LEAN_AND_MEAN

#include <winsock2.h>
#include <ws2tcpip.h>
#include <stdio.h>

// Need to link with Ws2_32.lib
#pragma comment(lib, "ws2_32.lib")

int wmain()
{

    //----------------------
    // Initialize Winsock
    WSADATA wsaData;
    int iResult = 0;

    SOCKET ListenSocket = INVALID_SOCKET;
    sockaddr_in service;

    iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != NO_ERROR) {
        wprintf(L"WSAStartup() failed with error: %d\n", iResult);
        return 1;
    }
    //----------------------
    // Create a SOCKET for listening for incoming connection requests.
    ListenSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ListenSocket == INVALID_SOCKET) {
        wprintf(L"socket function failed with error: %ld\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }
    //----------------------
    // The sockaddr_in structure specifies the address family,
    // IP address, and port for the socket that is being bound.
    service.sin_family = AF_INET;
    service.sin_addr.s_addr = inet_addr("127.0.0.1");
    service.sin_port = htons(27015);

    iResult = bind(ListenSocket, (SOCKADDR *) & service, sizeof (service));
    if (iResult == SOCKET_ERROR) {
        wprintf(L"bind function failed with error %d\n", WSAGetLastError());
        iResult = closesocket(ListenSocket);
        if (iResult == SOCKET_ERROR)
            wprintf(L"closesocket function failed with error %d\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }
    //----------------------
    // Listen for incoming connection requests 
    // on the created socket
    if (listen(ListenSocket, SOMAXCONN) == SOCKET_ERROR)
        wprintf(L"listen function failed with error: %d\n", WSAGetLastError());

    wprintf(L"Listening on socket...\n");

    iResult = closesocket(ListenSocket);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"closesocket function failed with error %d\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    WSACleanup();
    return 0;
}

コード例

IrDA ソケットに関する注意事項

• Af_irda.h ヘッダー ファイルは明示的に含まれている必要があります。

互換性

Windows Phone 8: この関数は、Windows Phone 8 以降の Windows Phone ストア アプリでサポートされています。

Windows 8.1とWindows Server 2012 R2: この関数は、Windows 8.1、Windows Server 2012 R2 以降の Windows ストア アプリでサポートされています。

要件

こちらもご覧ください

Winsock 関数

Winsock リファレンス

accept

connect

socket