setsockopt 函式 （winsock.h）

setsockopt 函數設定通訊端選項。

語法

int setsockopt(
  [in] SOCKET     s,
  [in] int        level,
  [in] int        optname,
  [in] const char *optval,
  [in] int        optlen
);

參數

[in] s

識別通訊端的描述元。

[in] level

定義選項的層級 （例如，SOL_SOCKET）。

[in] optname

要設定值的套接字選項 （例如，SO_BROADCAST）。 optname 參數必須是在指定層次內定義的通訊端選項，否則行為未定義。

[in] optval

指定所要求選項值之緩衝區的指標。

[in] optlen

optval 參數所指向的緩衝區大小 （以位元組為單位）。

傳回值

如果未發生錯誤，則 setsockopt 會傳回零。 否則，會傳回 SOCKET_ERROR 的值，而且可以呼叫 WSAGetLastError 來擷取特定的錯誤碼。

備註

setsockopt 函式會設定與任何狀態下任何類型的通訊端相關聯的通訊端選項的現行值。 雖然選項可以存在於多個通訊協定層級，但它們一律存在於最上層的通訊端層級。 選項會影響通訊端作業，例如是否在一般資料流程中接收加速資料 （例如 OOB 資料） ，以及是否可以在通訊端上傳送廣播訊息。

下表列出 setsockopt 函式支援的一些常見選項。 類型直欄會識別 optval 參數所定址的資料類型。 「描述」欄提供通訊端選項的一些基本資訊。 如需更完整的通訊端選項清單和更詳細的資訊 （例如預設值） ，請參閱 通訊端選項下的詳細主題。

平 = SOL_SOCKET

平 = IPPROTO_TCP

請參閱IPPROTO_TCP套接字選項中的TCP_NODELAY。 另請參閱該主題，以取得 層次 = IPPROTO_TCP的通訊端選項的更完整且詳細資訊。

平 = NSPROTO_IPX

如需有關 層級 = NSPROTO_IPX的通訊端選項的更完整和詳細資訊，請參閱 NSPROTO_IPX通訊端選項。

下表顯示 setsockopt 不支援的 BSD 選項。

範例程式碼

#ifndef UNICODE
#define UNICODE
#endif

#ifndef WIN32_LEAN_AND_MEAN
#define WIN32_LEAN_AND_MEAN
#endif

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

// Link with ws2_32.lib
#pragma comment(lib, "Ws2_32.lib")

int main()
{

    //---------------------------------------
    // Declare variables
    WSADATA wsaData;

    SOCKET ListenSocket;
    sockaddr_in service;

    int iResult = 0;

    BOOL bOptVal = FALSE;
    int bOptLen = sizeof (BOOL);

    int iOptVal = 0;
    int iOptLen = sizeof (int);

    //---------------------------------------
    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != NO_ERROR) {
        wprintf(L"Error at WSAStartup()\n");
        return 1;
    }
    //---------------------------------------
    // Create a listening socket
    ListenSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ListenSocket == INVALID_SOCKET) {
        wprintf(L"socket function failed with error: %u\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }
    //---------------------------------------
    // Bind the socket to the local IP address
    // and port 27015
    hostent *thisHost;
    char *ip;
    u_short port;
    port = 27015;
    thisHost = gethostbyname("");
    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) {
        wprintf(L"bind failed with error %u\n", WSAGetLastError());
        closesocket(ListenSocket);
        WSACleanup();
        return 1;
    }
    //---------------------------------------
    // Initialize variables and call setsockopt. 
    // The SO_KEEPALIVE parameter is a socket option 
    // that makes the socket send keepalive messages
    // on the session. The SO_KEEPALIVE socket option
    // requires a boolean value to be passed to the
    // setsockopt function. If TRUE, the socket is
    // configured to send keepalive messages, if FALSE
    // the socket configured to NOT send keepalive messages.
    // This section of code tests the setsockopt function
    // by checking the status of SO_KEEPALIVE on the socket
    // using the getsockopt function.

    bOptVal = TRUE;

    iResult = getsockopt(ListenSocket, SOL_SOCKET, SO_KEEPALIVE, (char *) &iOptVal, &iOptLen);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"getsockopt for SO_KEEPALIVE failed with error: %u\n", WSAGetLastError());
    } else
        wprintf(L"SO_KEEPALIVE Value: %ld\n", iOptVal);

    iResult = setsockopt(ListenSocket, SOL_SOCKET, SO_KEEPALIVE, (char *) &bOptVal, bOptLen);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"setsockopt for SO_KEEPALIVE failed with error: %u\n", WSAGetLastError());
    } else
        wprintf(L"Set SO_KEEPALIVE: ON\n");

    iResult = getsockopt(ListenSocket, SOL_SOCKET, SO_KEEPALIVE, (char *) &iOptVal, &iOptLen);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"getsockopt for SO_KEEPALIVE failed with error: %u\n", WSAGetLastError());
    } else
        wprintf(L"SO_KEEPALIVE Value: %ld\n", iOptVal);

    closesocket(ListenSocket);
    WSACleanup();
    return 0;
}

IrDA 插槽注意事項

使用適用於 IrDA 的 Windows 通訊端開發應用程式時，請注意下列事項：

• 必須明確包含 Af_irda.h 標頭檔。
• IrDA 提供下列通訊端選項：

  價值觀	類型	Meaning
  IRLMP_IAS_SET	*IAS_SET	設定 IAS 屬性

   

IRLMP_IAS_SET 通訊端選項可讓應用程式在本機 IAS 中設定單一類別的單一屬性。 應用程式會指定要設定的類別、屬性及屬性類型。 應用程式預期會為傳遞的參數配置必要大小的緩衝區。

IrDA 提供 IAS 資料庫，可儲存 IrDA 型資訊。 透過 Windows Sockets 2 介面可取得 IAS 資料庫的有限存取權，但應用程式通常不會使用這類存取權，而且主要是為了支援與不符合 Windows Sockets 2 IrDA 慣例的非 Windows 裝置連線。

下列結構 IAS_SET 會與 IRLMP_IAS_SET setsockopt 選項搭配使用，以管理本機 IAS 資料庫：

// #include <Af_irda.h> for this struct

typedef struct _IAS_SET {
    u_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_SET, *PIAS_SET, FAR *LPIASSET;

下列結構 IAS_QUERY 會與 IRLMP_IAS_QUERY setsockopt 選項搭配使用，以查詢對等的 IAS 資料庫：

// #include <Af_irda.h> for this struct

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 *LPIASQUERY;

許多SO_層級通訊端選項對 IrDA 沒有意義。 只有SO_LINGER特別支援。

Windows 電話 8： Windows Phone 8 和更新版本上的 Windows Phone 市集應用程式支援此功能。

Windows 8.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 和更新版本上的 Windows 市集應用程式支援此功能。

需求

另請參閱

IPPROTO_IP 插座選項

IPPROTO_IPV6 插座選項

IPPROTO_RM 插座選項

IPPROTO_TCP插座選項

IPPROTO_UDP插座選項

NSPROTO_IPX 插座選項

SOL_APPLETALK 插座選項

SOL_IRLMP 插座選項

SOL_SOCKET插座選項

套接字選項

WSAAsyncSelect

WSAEventSelect

WSAIoctl

Winsock 函數

綁

getsockopt

ioctl暫接字

插座