どんな型の、どんな状態のソケットと関連したソケットオプション用のカレント値を setsockopt 関数は、セットします。 オプションが複数のプロトコルレベルに存在することができるけれども、 彼らは最上ソケットレベルで常にいます。 オプションはソケット操作に影響を及ぼします、 促進されたデータ (たとえばOOBデータ) が通常のデータストリームで受け取られるかどうかのような、 そして、ブロードキャストメッセージがソケットで送られることができるかどうかに関係なく。

ノート   もし setsockopt 関数が bind 関数の前に呼ばれるならば、 bind が起こるまで、TCP/IP オプションは TCP/IP と照合されません。 この場合、 setsockopt 関数呼び出しは、常に成功します、 しかし、bind 関数呼び出しは、 失敗している初期の setsockopt のため、失敗することがありえます。

ノート   もしソケットが開かれるならば、setsockopt 呼び出しはなされます、 Windows Socketsは、潜在的な bind 関数呼び出しを実行します。

2種類のソケットオプションがあります: 特徴またはふるまいを可能または不可にするブールオプションと整数値または構造を必要とするオプション。 ブールオプションを可能にするために、optval パラメータは、ゼロ以外の整数を指します。 オプションを使用不能にするために、optvalはゼロと等しい整数を指します。 optlen パラメータは、ブールオプションのために sizeof(int) と等しくなければなりません。 optval はオプションのために望ましい値を含む整数または構造を指します、 そして、optlen は整数または構造の長さです。

以下のオプションは、setsockopt のためにサポートされます。 これらのオプションのデフォルト値のために、説明を見てください。 optval によってアドレスされるデータの型を、型は識別します。

ソケットオプションの詳細については、Socket Options を見てください。

ノート   Windows NT はすべての IPX オプションをサポートします。 Windows Me/98/95 は以下のオプションだけをサポートします:

IPX_PTYPE
IPX_FILTERPTYPE
IPX_DSTYPE
IPX_RECVHDR
IPX_MAXSIZE (getsockopt 関数と共に使用されます)
IPX_ADDRESS (getsockopt 関数と共に使用されます)

/*
 * file:winsock2setsockopt_example1.c
 * The setsockopt function sets a socket option.
 * 参照 http://msdn2.microsoft.com/en-us/library/ms740476.aspx
 */
#include <stdio.h>
#include <winsock2.h>

int main(int argc, char *argv[])
{
    /*
     * 変数を宣言
     */
    WSADATA             wsaData;
    SOCKET              ListenSocket    = INVALID_SOCKET;
    struct sockaddr_in  service;
    int                 iResult         = 0;
    struct hostent      *thisHost       = NULL;
    char                *ip             = NULL;
    u_short             port            = 0;
    BOOL                boOptVal        = FALSE;
    int                 iOptLen         = 0;
    int                 iOptVal         = 0;
    
    /*
     * winsockを初期化
     */
    iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult)
    {
        printf("WSAStartup() Failed.\n");
        return 1;
    }
    
    /*
     * 聞き取り用ソケットを作成
     */
    ListenSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ListenSocket == INVALID_SOCKET)
    {
        printf("socket() Failed.\n");
        WSACleanup();
        return 1;
    }
    
    /*
     * ローカルIPアドレスとポート27015にソケットをバインドする
     */
    port = 27015;
    thisHost = gethostbyname("");
    if (thisHost == NULL)
    {
        printf("gethostbyname() Failed.\n");
        closesocket(ListenSocket);
        WSACleanup();
        return 1;
    }
    ip = inet_ntoa(*(struct in_addr *)*thisHost->h_addr_list);
    
    service.sin_family = AF_INET;
    service.sin_addr.s_addr = inet_addr(ip);
    service.sin_port = htons(port);
    
    iResult = bind(ListenSocket, (SOCKADDR *)&service, sizeof(service));
    if (iResult == SOCKET_ERROR)
    {
        printf("bind() Failed.\n");
        closesocket(ListenSocket);
        WSACleanup();
        return 1;
    }
    
    /*
     * 変数の初期化と、setsockopt呼び出し。
     * SO_KEEPALIVE パラメータは、ソケットがセッションで keepalive メ
     * ッセージを送らせるソケットオプションです。SO_KEEPALIVE ソケット
     * オプションは、setsockopt 関数を通過できるブール値を要求します。
     * もし TRUE ならば、構成されるソケットは keepalive メッセージを送
     * ります、もし FALSE ならば、構成されるソケットは keepalive メッ
     * セージを送りません。コードのこの部分は、getsockopt 関数を使用し
     * ているソケット上にて、SO_KEEPALIVE の状態をチェックすることによ
     * って、setsockopt 関数をテストします。
    */
    boOptVal    = TRUE;
    
    iOptLen = sizeof(int);
    iResult = getsockopt(ListenSocket, SOL_SOCKET, SO_KEEPALIVE
            , (char *)&iOptVal, &iOptLen);
    if (iResult != SOCKET_ERROR)
    {
        printf("SO_KEEPALIVE value: %ld\n", iOptVal);
    }
    
    iOptLen = sizeof(BOOL);
    iResult = setsockopt(ListenSocket, SOL_SOCKET, SO_KEEPALIVE
            , (char *)&boOptVal, iOptLen);
    if (iResult != SOCKET_ERROR)
    {
        printf("Set SO_KEEPALIVE: ON\n");
    }

    iOptLen = sizeof(int);
    iResult = getsockopt(ListenSocket, SOL_SOCKET, SO_KEEPALIVE
            , (char *)&iOptVal, &iOptLen);
    if (iResult != SOCKET_ERROR)
    {
        printf("SO_KEEPALIVE value: %ld\n", iOptVal);
    }
    
    closesocket(ListenSocket);
    WSACleanup();
    return 0;
}

以下を覚えておいてください:

• Af_irda.h ヘッダファイルは、明確にインクルードされなければなりません。
• IrDA は、以下のセット可能なソケットオプションを提供します:

  値 型 意味 IRLMP_IAS_SET *IAS_SET IAS 属性をセットします

IRLMP_IAS_SET ソケットオプションは、アプリケーションが一つのクラスの一つの属性 をローカルの IAS でセットする事を有効にします。 アプリケーションは、属性と属性タイプのセットへクラスを指定します。 アプリケーションは、必要なサイズのバッファを渡されたパラメータに割り当てることになっています。

IrDA は、IrDA に基づく情報を格納するIASデータベースを提供します。 IAS データベースへの限られたアクセスは、Windows Sockets 2 interface を通して手に入ります、 しかし、そのようなアクセスは、アプリケーションにより通常用いられません、 そして、主に Windows Sockets 2 IrDA 協定で素直でない非Windowsデバイスへの接続をサポートするために存在します。

typedef struct _IAS_SET {
    char      irdaClassName[IAS_MAX_CLASSNAME];
    char      irdaAttribName[IAS_MAX_ATTRIBNAME];
    u_long    irdaAttribType;
    union
    {
              LONG irdaAttribInt;
              struct
              {
                   u_short   Len;
                   u_char    OctetSeq[IAS_MAX_OCTET_STRING];
              } irdaAttribOctetSeq;
              struct
              {
                   u_char    Len;
                   u_char    CharSet;
                   u_char    UsrStr[IAS_MAX_USER_STRING];
              } irdaAttribUsrStr;
    } irdaAttribute;
} IAS_SET, *PIAS_SET, FAR *LPIAS_SET;

typedef struct _WINDOWS_IAS_QUERY {
        u_char   irdaDeviceID[4];
        char     irdaClassName[IAS_MAX_CLASSNAME];
        char     irdaAttribName[IAS_MAX_ATTRIBNAME];
        u_long   irdaAttribType;
        union
        {
                  LONG    irdaAttribInt;
                  struct
                  {
                          u_long  Len;
                          u_char  OctetSeq[IAS_MAX_OCTET_STRING];
                  } irdaAttribOctetSeq;
                  struct
                  {
                          u_long  Len;
                          u_long  CharSet;
                          u_char  UsrStr[IAS_MAX_USER_STRING];
                  } irdaAttribUsrStr;
        } irdaAttribute;
} IAS_QUERY, *PIAS_QUERY, FAR *LPIAS_QUERY;

多くの SO_ レベルソケットオプションは、IrDA に意味がありません。 SO_LINGER だけは、特別にサポートされます。

ノート   setsockopt は、Windows NT 4.0, Windows 95, そして Windows 98 プラットフォーム上にて bind する前に呼ばれなければなりません。